Portal Revision - Create Or Update

Servizio:: API Management

Versione API:: 2024-05-01

Crea una nuova revisione del portale per sviluppatori eseguendo la pubblicazione del portale. La proprietà isCurrent indica se la revisione è accessibile pubblicamente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalRevisions/{portalRevisionId}?api-version=2024-05-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
portalRevisionId	path	True	string minLength: 1 maxLength: 256	Identificatore di revisione del portale. Deve essere univoco nell'istanza corrente del servizio Gestione API.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	Nome del servizio Gestione API.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.description	string maxLength: 2000	Descrizione della revisione del portale.
properties.isCurrent	boolean	Indica se la revisione del portale è pubblica.

Risposte

Nome	Tipo	Descrizione
201 Created	PortalRevisionContract	La revisione del portale per sviluppatori è stata creata correttamente. Intestazioni ETag: string location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Nome

Tipo

Descrizione

201 Created

PortalRevisionContract

La revisione del portale per sviluppatori è stata creata correttamente.

Intestazioni

ETag: string
location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ApiManagementCreatePortalRevision

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalRevisions/20201112101010?api-version=2024-05-01

{
  "properties": {
    "description": "portal revision 1",
    "isCurrent": true
  }
}

Risposta di esempio

Codice di stato:: 201

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalRevisions/20201112101010?api-version=2024-05-01&asyncId=5faf089b1d9a026694220e0c&asyncCode=201
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5faf089b1d9a026694220e0c?api-version=2024-05-01

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/portalRevisions/20201112101010",
  "type": "Microsoft.ApiManagement/service/portalRevisions",
  "name": "20201112101010",
  "properties": {
    "description": "portal revision 1",
    "statusDetails": null,
    "status": "completed",
    "isCurrent": true,
    "createdDateTime": "2020-11-13T22:28:43.657Z",
    "updatedDateTime": "2020-11-13T22:29:22.68Z",
    "provisioningState": "InProgress"
  }
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PortalRevisionContract	Dettagli del contratto di revisione del portale.
portalRevisionStatus	Stato della revisione del portale.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PortalRevisionContract

Object

Dettagli del contratto di revisione del portale.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.createdDateTime	string (date-time)	Data e ora di creazione della revisione del portale.
properties.description	string maxLength: 2000	Descrizione della revisione del portale.
properties.isCurrent	boolean	Indica se la revisione del portale è pubblica.
properties.provisioningState	string	Stato del provisioning
properties.status	portalRevisionStatus	Stato della revisione del portale.
properties.statusDetails	string maxLength: 2000	Dettagli sullo stato di pubblicazione della revisione del portale.
properties.updatedDateTime	string (date-time)	Data e ora dell'ultimo aggiornamento.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

portalRevisionStatus

Enumerazione

Stato della revisione del portale.

Valore	Descrizione
pending	La revisione del portale è stata accodata.
publishing	La revisione del portale viene pubblicata.
completed	Pubblicazione della revisione del portale completata.
failed	Pubblicazione della revisione del portale non riuscita.