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 |
---|---|---|---|---|
configuration
|
path | True |
Der Bezeichner des Git-Konfigurationsvorgangs. |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
service
|
path | True |
string |
Der Name des API Management-Diensts. RegEx-Muster: |
subscription
|
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 |
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 |
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
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 |
---|---|
Async |
Status eines asynchronen Vorgangs. |
configuration |
Der Bezeichner des Git-Konfigurationsvorgangs. |
Deploy |
Bereitstellen eines Mandantenkonfigurationsvertrags. |
Error |
Fehlerfeldvertrag. |
Error |
Fehlerantwort. |
Error |
Fehlertextvertrag. |
Operation |
Ergebnisse des Git-Vorgangs mit langer Ausführungsdauer. |
Operation |
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 |
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 |
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 |
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 |
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: |
properties.status |
Status eines asynchronen Vorgangs. |
|
properties.updated |
string |
Zeitpunkt der letzten Aktualisierung eines asynchronen Vorgangs. Das Datum entspricht dem folgenden Format: |
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. |