Set-AzApiManagementApiRevision
Modifica uma revisão de API
Syntax
Set-AzApiManagementApiRevision
-ApiRevision <String>
-Context <PsApiManagementContext>
-ApiId <String>
[-Name <String>]
[-Description <String>]
[-ServiceUrl <String>]
[-Path <String>]
[-Protocols <PsApiManagementSchema[]>]
[-AuthorizationServerId <String>]
[-AuthorizationScope <String>]
[-OpenIdProviderId <String>]
[-BearerTokenSendingMethod <String[]>]
[-SubscriptionKeyHeaderName <String>]
[-SubscriptionKeyQueryParamName <String>]
[-SubscriptionRequired]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzApiManagementApiRevision
-InputObject <PsApiManagementApi>
[-Name <String>]
[-Description <String>]
[-ServiceUrl <String>]
[-Path <String>]
[-Protocols <PsApiManagementSchema[]>]
[-AuthorizationServerId <String>]
[-AuthorizationScope <String>]
[-OpenIdProviderId <String>]
[-BearerTokenSendingMethod <String[]>]
[-SubscriptionKeyHeaderName <String>]
[-SubscriptionKeyQueryParamName <String>]
[-SubscriptionRequired]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Set-AzApiManagementApiRevision modifica uma revisão da API de Gerenciamento de API do Azure.
Exemplos
Exemplo 1: Modificar uma revisão de API
$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementApiRevision -Context $ApiMgmtContext -ApiId "echo-api" -ApiRevision "2" -Name "EchoApi" -ServiceUrl "https://contoso.com/apis/echo" -Protocols @('https') -Description "Responds with what was sent" -Path "echo"O cmdlet atualiza a 2 revisão da API echo-api com uma nova descrição, protocolo e caminho.
Parâmetros
-ApiId
Identificador da API existente. Este parâmetro é obrigatório.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApiRevision
Identificador da revisão da API existente. Este parâmetro é obrigatório.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AuthorizationScope
Escopo das operações OAuth. Este parâmetro é opcional. O valor padrão é $null.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AuthorizationServerId
Identificador do servidor de autorização OAuth. Este parâmetro é opcional. O valor padrão é $null. Deve ser especificado se AuthorizationScope especificado.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BearerTokenSendingMethod
Mecanismo do servidor de autorização OpenId pelo qual o token de acesso é passado para a API. Consulte https://datatracker.ietf.org/doc/html/rfc6749#section-4. Este parâmetro é opcional. O valor padrão é $null.
| Tipo: | String[] |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Context
Instância de PsApiManagementContext. Este parâmetro é obrigatório.
| Tipo: | PsApiManagementContext |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Descrição da API Web. Este parâmetro é opcional.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputObject
Instância de PsApiManagementApi. Este parâmetro é obrigatório.
| Tipo: | PsApiManagementApi |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Nome da API Web. Nome público da API como ela apareceria nos portais de desenvolvedor e administração. Este parâmetro é obrigatório.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OpenIdProviderId
Identificador do servidor de autorização OpenId. Este parâmetro é opcional. O valor padrão é $null. Deve ser especificado se BearerTokenSendingMethods for especificado.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
Se especificado, então instância de Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementApi tipo que representa a API definida.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
Caminho da API Web. Última parte da URL pública da API. Esse URL será usado pelos consumidores da API para enviar solicitações ao serviço Web. Deve ter de 1 a 400 caracteres. Este parâmetro é opcional. O valor padrão é $null.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Protocols
Protocolos de API Web (http, https). Protocolos sobre os quais a API é disponibilizada. Este parâmetro é obrigatório. O valor padrão é $null.
| Tipo: | PsApiManagementSchema[] |
| valores aceites: | Http, Https |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceUrl
Uma URL do serviço Web expondo a API. Essa URL será usada apenas pelo Gerenciamento de API do Azure e não será tornada pública. Deve ter de 1 a 2000 caracteres. Este parâmetro é obrigatório.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionKeyHeaderName
Nome do cabeçalho da chave de assinatura. Este parâmetro é opcional. O valor padrão é $null.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionKeyQueryParamName
Nome do parâmetro da cadeia de caracteres de consulta da chave de assinatura. Este parâmetro é opcional. O valor padrão é $null.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionRequired
Sinalizador para impor SubscriptionRequired para solicitações à Api. Este parâmetro é opcional.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Ligações Relacionadas
Azure PowerShell
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários