Tenant Configuration - Validate

Dieser Vorgang überprüft die Änderungen im angegebenen Git-Branch. Dies ist ein lang andauernder Vorgang, der einige Minuten dauern kann.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/configuration/validate?api-version=2021-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
configurationName
path True

configurationIdName

Der Bezeichner des Git-Konfigurationsvorgangs.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

serviceName
path True

string

Der Name des API Management-Diensts.

RegEx-Muster: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.branch True

string

Der Name des Git-Branchs, von dem aus die Konfiguration in der Konfigurationsdatenbank bereitgestellt werden soll.

properties.force

boolean

Der Wert, der das Löschen von Abonnements für Produkte erzwingt, die in diesem Update gelöscht werden.

Antworten

Name Typ Beschreibung
200 OK

OperationResultContract

Ergebnis der Überprüfung der Änderungen im angegebenen Git-Branch.

202 Accepted

Akzeptiert: Der Speicherortheader enthält die URL, in der die status des vorgangs mit langer Ausführung überprüft werden kann.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ApiManagementTenantConfigurationValidate

Beispielanforderung

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/configuration/validate?api-version=2021-08-01

{
  "properties": {
    "branch": "master"
  }
}

Beispiel für eine Antwort

location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af64e2a6d2e0b688d751e?api-version=2021-08-01
{
  "id": "6074ec02093a9d0dac3d7345",
  "type": "Microsoft.ApiManagement/service/tenant/operationResults",
  "name": "6074ec02093a9d0dac3d7345",
  "properties": {
    "status": "Succeeded",
    "started": "2021-04-13T00:55:30.62Z",
    "updated": "2021-04-13T00:55:39.857Z",
    "resultInfo": "Validation is successfull",
    "actionLog": []
  }
}

Definitionen

Name Beschreibung
AsyncOperationStatus

Status eines asynchronen Vorgangs.

configurationIdName

Der Bezeichner des Git-Konfigurationsvorgangs.

DeployConfigurationParameters

Bereitstellen eines Mandantenkonfigurationsvertrags.

ErrorFieldContract

Fehlerfeldvertrag.

ErrorResponse

Fehlerantwort.

ErrorResponseBody

Fehlertextvertrag.

OperationResultContract

Ergebnisse des Git-Vorgangs mit langer Ausführungsdauer.

OperationResultLogItemContract

Protokoll der Entität, die erstellt, aktualisiert oder gelöscht wird.

AsyncOperationStatus

Status eines asynchronen Vorgangs.

Name Typ Beschreibung
Failed

string

InProgress

string

Started

string

Succeeded

string

configurationIdName

Der Bezeichner des Git-Konfigurationsvorgangs.

Name Typ Beschreibung
configuration

string

DeployConfigurationParameters

Bereitstellen eines Mandantenkonfigurationsvertrags.

Name Typ Beschreibung
properties.branch

string

Der Name des Git-Branchs, von dem aus die Konfiguration in der Konfigurationsdatenbank bereitgestellt werden soll.

properties.force

boolean

Der Wert, der das Löschen von Abonnements für Produkte erzwingt, die in diesem Update gelöscht werden.

ErrorFieldContract

Fehlerfeldvertrag.

Name Typ Beschreibung
code

string

Fehlercode auf Eigenschaftsebene.

message

string

Für Menschen lesbare Darstellung eines Fehlers auf Eigenschaftsebene.

target

string

Der Eigenschaftsname.

ErrorResponse

Fehlerantwort.

Name Typ Beschreibung
error.code

string

Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode.

error.details

ErrorFieldContract[]

Die Liste der ungültigen Felder, die im Falle eines Überprüfungsfehlers gesendet werden.

error.message

string

Lesbare Darstellung des Fehlers.

ErrorResponseBody

Fehlertextvertrag.

Name Typ Beschreibung
code

string

Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode.

details

ErrorFieldContract[]

Die Liste der ungültigen Felder, die im Falle eines Überprüfungsfehlers gesendet werden.

message

string

Lesbare Darstellung des Fehlers.

OperationResultContract

Ergebnisse des Git-Vorgangs mit langer Ausführungsdauer.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.actionLog

OperationResultLogItemContract[]

Diese Eigenschaft wird nur im Rahmen des TenantConfiguration_Validate-Vorgangs bereitgestellt. Es enthält das Protokoll der Entitäten, die im Rahmen des TenantConfiguration_Deploy-Vorgangs aktualisiert/erstellt/gelöscht werden.

properties.error

ErrorResponseBody

Fehlertextvertrag

properties.id

string

Ergebnisbezeichner des Vorgangs.

properties.resultInfo

string

Optionale Ergebnisinformationen.

properties.started

string

Startzeit eines asynchronen Vorgangs. Das Datum entspricht dem folgenden Format: yyyy-MM-ddTHH:mm:ssZ gemäß der ISO 8601-Norm.

properties.status

AsyncOperationStatus

Status eines asynchronen Vorgangs.

properties.updated

string

Zeitpunkt der letzten Aktualisierung eines asynchronen Vorgangs. Das Datum entspricht dem folgenden Format: yyyy-MM-ddTHH:mm:ssZ gemäß der ISO 8601-Norm.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

OperationResultLogItemContract

Protokoll der Entität, die erstellt, aktualisiert oder gelöscht wird.

Name Typ Beschreibung
action

string

Aktion wie erstellen/aktualisieren/löschen.

objectKey

string

Bezeichner der Entität, die erstellt/aktualisiert/gelöscht wird.

objectType

string

Der Typ des Entitätsvertrags.