Tenant Configuration - Deploy
Ta operacja powoduje zastosowanie zmian z określonej gałęzi Git do bazy danych konfiguracji. Jest to długotrwała operacja i może potrwać kilka minut.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/configuration/deploy?api-version=2022-08-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
configuration
|
path | True |
Identyfikator operacji konfiguracji usługi Git. |
|
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
service
|
path | True |
string |
Nazwa usługi API Management. Regex pattern: |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
properties.branch | True |
string |
Nazwa gałęzi Git, z której konfiguracja ma zostać wdrożona w bazie danych konfiguracji. |
properties.force |
boolean |
Wartość wymuszającą usuwanie subskrypcji do produktów, które zostały usunięte w tej aktualizacji. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Wynik zastosowania zmian z gałęzi Git do bazy danych. |
|
202 Accepted |
Zaakceptowane: nagłówek lokalizacji zawiera adres URL, pod którym można sprawdzić stan długotrwałej operacji. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
ApiManagementTenantConfigurationDeploy
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/configuration/deploy?api-version=2022-08-01
{
"properties": {
"branch": "master"
}
}
Sample Response
location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af4ae2a6d2e0b688d7517?api-version=2022-08-01
{
"id": "6074e652093a9d0dac3d733c",
"type": "Microsoft.ApiManagement/service/tenant/operationResults",
"name": "6074e652093a9d0dac3d733c",
"properties": {
"status": "Failed",
"started": "2017-11-26T17:06:54.303Z",
"updated": "2017-11-26T17:07:21.777Z",
"error": {
"code": "ValidationError",
"message": "File not found: 'api-management/configuration.json'"
}
}
}
Definicje
Nazwa | Opis |
---|---|
Async |
Stan operacji asynchronicznych. |
configuration |
Identyfikator operacji konfiguracji usługi Git. |
Deploy |
Wdrażanie kontraktu konfiguracji dzierżawy. |
Error |
Błąd Kontrakt pola. |
Error |
Odpowiedź na błąd. |
Error |
Kontrakt treści błędu. |
Operation |
Długotrwałe wyniki operacji git. |
Operation |
Dziennik tworzonej, aktualizowanej lub usuwanej jednostki. |
AsyncOperationStatus
Stan operacji asynchronicznych.
Nazwa | Typ | Opis |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
Started |
string |
|
Succeeded |
string |
configurationIdName
Identyfikator operacji konfiguracji usługi Git.
Nazwa | Typ | Opis |
---|---|---|
configuration |
string |
DeployConfigurationParameters
Wdrażanie kontraktu konfiguracji dzierżawy.
Nazwa | Typ | Opis |
---|---|---|
properties.branch |
string |
Nazwa gałęzi Git, z której konfiguracja ma zostać wdrożona w bazie danych konfiguracji. |
properties.force |
boolean |
Wartość wymuszającą usuwanie subskrypcji do produktów, które zostały usunięte w tej aktualizacji. |
ErrorFieldContract
Błąd Kontrakt pola.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu poziomu właściwości. |
message |
string |
Czytelna dla człowieka reprezentacja błędu na poziomie właściwości. |
target |
string |
Nazwa właściwości. |
ErrorResponse
Odpowiedź na błąd.
Nazwa | Typ | Opis |
---|---|---|
error.code |
string |
Kod błędu zdefiniowany przez usługę. Ten kod służy jako podstan kodu błędu HTTP określonego w odpowiedzi. |
error.details |
Lista nieprawidłowych pól jest wysyłana w żądaniu w przypadku błędu walidacji. |
|
error.message |
string |
Czytelna dla człowieka reprezentacja błędu. |
ErrorResponseBody
Kontrakt treści błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu zdefiniowany przez usługę. Ten kod służy jako podstan kodu błędu HTTP określonego w odpowiedzi. |
details |
Lista nieprawidłowych pól jest wysyłana w żądaniu w przypadku błędu walidacji. |
|
message |
string |
Czytelna dla człowieka reprezentacja błędu. |
OperationResultContract
Długotrwałe wyniki operacji git.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nazwa zasobu |
properties.actionLog |
Ta właściwość, jeśli jest podana tylko w ramach operacji TenantConfiguration_Validate. Zawiera on dziennik jednostek, które zostaną zaktualizowane/utworzone/usunięte w ramach operacji TenantConfiguration_Deploy. |
|
properties.error |
Kontrakt treści błędu |
|
properties.id |
string |
Identyfikator wyniku operacji. |
properties.resultInfo |
string |
Opcjonalne informacje o wynikach. |
properties.started |
string |
Godzina rozpoczęcia operacji asynchronicznych. Data jest zgodna z następującym formatem: |
properties.status |
Stan operacji asynchronicznych. |
|
properties.updated |
string |
Czas ostatniej aktualizacji operacji asynchronicznych. Data jest zgodna z następującym formatem: |
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
OperationResultLogItemContract
Dziennik tworzonej, aktualizowanej lub usuwanej jednostki.
Nazwa | Typ | Opis |
---|---|---|
action |
string |
Akcja, na przykład create/update/delete. |
objectKey |
string |
Identyfikator tworzonej/aktualizowanej/usuniętej jednostki. |
objectType |
string |
Typ kontraktu jednostki. |