{"id":27867765,"url":"https://github.com/ralish/psciscosupportapis","last_synced_at":"2025-05-04T22:53:32.332Z","repository":{"id":37599861,"uuid":"163134199","full_name":"ralish/PSCiscoSupportAPIs","owner":"ralish","description":"PowerShell interface to the Cisco Support APIs","archived":false,"fork":false,"pushed_at":"2024-03-11T05:53:34.000Z","size":95,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-03-11T06:41:05.270Z","etag":null,"topics":["cisco","powershell","sysadmin"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ralish.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-12-26T03:58:42.000Z","updated_at":"2023-07-25T14:22:31.000Z","dependencies_parsed_at":"2023-12-10T01:42:08.762Z","dependency_job_id":null,"html_url":"https://github.com/ralish/PSCiscoSupportAPIs","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralish%2FPSCiscoSupportAPIs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralish%2FPSCiscoSupportAPIs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralish%2FPSCiscoSupportAPIs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralish%2FPSCiscoSupportAPIs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ralish","download_url":"https://codeload.github.com/ralish/PSCiscoSupportAPIs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252411819,"owners_count":21743604,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cisco","powershell","sysadmin"],"created_at":"2025-05-04T22:53:31.778Z","updated_at":"2025-05-04T22:53:32.326Z","avatar_url":"https://github.com/ralish.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"PSCiscoSupportAPIs\n==================\n\n[![pwsh ver](https://img.shields.io/powershellgallery/v/PSCiscoSupportAPIs)](https://www.powershellgallery.com/packages/PSCiscoSupportAPIs)\n[![pwsh dl](https://img.shields.io/powershellgallery/dt/PSCiscoSupportAPIs)](https://www.powershellgallery.com/packages/PSCiscoSupportAPIs)\n[![license](https://img.shields.io/github/license/ralish/PSCiscoSupportAPIs)](https://choosealicense.com/licenses/mit/)\n\nA PowerShell interface to the [Cisco Support APIs](https://developer.cisco.com/site/support-apis/).\n\n- [Requirements](#requirements)\n- [Installing](#installing)\n- [Configuring](#configuring)\n- [API endpoints](#api-endpoints)\n- [Troubleshooting](#troubleshooting)\n- [License](#license)\n\nRequirements\n------------\n\n- PowerShell 3.0 (or later)\n- [Cisco Support APIs credentials](https://apiconsole.cisco.com/)\n\nInstalling\n----------\n\n### PowerShellGet (included with PowerShell 5.0)\n\nThe module is published to the [PowerShell Gallery](https://www.powershellgallery.com/packages/PSCiscoSupportAPIs):\n\n```posh\nInstall-Module -Name PSCiscoSupportAPIs\n```\n\n### ZIP File\n\nDownload the [ZIP file](https://github.com/ralish/PSCiscoSupportAPIs/archive/stable.zip) of the latest release and unpack it to one of the following locations:\n\n- Current user: `C:\\Users\\\u003cyour.account\u003e\\Documents\\WindowsPowerShell\\Modules\\PSCiscoSupportAPIs`\n- All users: `C:\\Program Files\\WindowsPowerShell\\Modules\\PSCiscoSupportAPIs`\n\n### Git Clone\n\nYou can also clone the repository into one of the above locations if you'd like the ability to easily update it via Git.\n\n### Did it work?\n\nYou can check that PowerShell is able to locate the module by running the following at a PowerShell prompt:\n\n```posh\nGet-Module PSCiscoSupportAPIs -ListAvailable\n```\n\nConfiguring\n-----------\n\n### API credentials\n\nYou must provide your API credentials to make requests. This can be done by either:\n\n- Setting the `$CiscoApiClientId` and `$CiscoApiClientSecret` variables globally.\n- Providing the `-ClientId` and `-ClientSecret` parameters on command invocation.\n\nCommand parameters take precedence over any globally configured API credentials.\n\n### Response formats\n\nAll commands support outputting the response in several formats:\n\n- `PSObject` (_default_)  \n  A `PSCustomObject` which maps the fields in the JSON response. The raw response may be manipulated to improve its representation (e.g. using optimal .NET types). Formatting information is included for these objects, making them typically the easiest to work with, particularly interactively.\n- `JSON`  \n  A `String` containing the raw JSON response. You can pipe this to `ConvertFrom-Json` to generate a `PSCustomObject` representation. Note this will not give you the same result as the `PSObject` response format, which performs additional manipulation alongside formatting data to provide a \"_native_\" PowerShell experience.\n- `WebResponse`  \n  A `BasicHtmlWebResponseObject` which includes the response metadata (e.g. status code, HTTP headers, etc ...) alongside the response content. The `Content` property contains the raw JSON response and is identical to that returned in the `JSON` response format.\n\nThe response format is controlled by:\n\n- Setting the `$CiscoApiResponseFormat` variable globally.\n- Providing the `-ResponseFormat` parameter on command invocation.\n\nCommand parameters take precedence over any globally configured response format.\n\nAPI endpoints\n-------------\n\nThe following table shows the required API for each command:\n\n| API Name                                                                                                           | API Version | Command(s) |\n| ------------------------------------------------------------------------------------------------------------------ | ------------| ---------- |\n| [Automated Software Distribution](https://developer.cisco.com/docs/support-apis/#!automated-software-distribution) | v4          | `Get-CiscoSoftwareDownload`\u003cbr\u003e`Get-CiscoSoftwareRelease`\u003cbr\u003e`Get-CiscoSoftwareStatus` |\n| [Product Information](https://developer.cisco.com/docs/support-apis/#!product-information)                         | v1          | `Get-CiscoProductInformation` |\n| [Serial Number to Information](https://developer.cisco.com/docs/support-apis/#!serial-number-to-information)       | v2          | `Get-CiscoCoverageInformation`\u003cbr\u003e`Get-CiscoOrderableProductId` |\n| [Service Order Return (RMA)](https://developer.cisco.com/docs/support-apis/#!service-order-return-rma)             | v1          | `Get-CiscoServiceOrderReturn` |\n| [Software Suggestion](https://developer.cisco.com/docs/support-apis/#!software-suggestion)                         | v2          | `Get-CiscoSoftwareSuggestion` |\n\nTroubleshooting\n---------------\n\nEncountering unexpected behaviour or other problems? You may wish to run the problematic command with the `-Verbose` parameter for more details. You can also add the `-Debug` parameter for even more details on the command processing.\n\nIf you think you've found a bug please consider [opening an issue](https://github.com/ralish/PSCiscoSupportAPIs/issues) so that I can look into it and hopefully get it fixed!\n\nLicense\n-------\n\nAll content is licensed under the terms of [The MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralish%2Fpsciscosupportapis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fralish%2Fpsciscosupportapis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralish%2Fpsciscosupportapis/lists"}