Tenant Configuration - Save
Den här åtgärden skapar en incheckning med den aktuella konfigurationsögonblicksbilden till den angivna grenen på lagringsplatsen. Det här är en tidskrävande åtgärd som kan ta flera minuter att slutföra.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/configuration/save?api-version=2022-08-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
configuration
|
path | True |
Identifieraren för Git-konfigurationsåtgärden. |
|
resource
|
path | True |
string |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
service
|
path | True |
string |
Namnet på API Management-tjänsten. Regex pattern: |
subscription
|
path | True |
string |
ID för målprenumerationen. |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
properties.branch | True |
string |
Namnet på Git-grenen där den aktuella konfigurationsögonblicksbilden ska checkas in. |
properties.force |
boolean |
Värdet om det är sant, den aktuella konfigurationsdatabasen checkas in på Git-lagringsplatsen, även om Git-lagringsplatsen har nyare ändringar som skulle skrivas över. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Resultatet av att skapa en incheckning på lagringsplatsen. |
|
202 Accepted |
Accepterad: Platsrubriken innehåller den URL där statusen för den långvariga åtgärden kan kontrolleras. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
ApiManagementTenantConfigurationSave
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/configuration/save?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/5a1af57d2a6d2e0b688d751b?api-version=2022-08-01
{
"id": "6074e652093a9d0dac3d733c",
"type": "Microsoft.ApiManagement/service/tenant/operationResults",
"name": "6074e652093a9d0dac3d733c",
"properties": {
"status": "Succeeded",
"started": "2021-04-13T00:31:14.94Z",
"updated": "2021-04-13T00:31:27.59Z",
"resultInfo": "The configuration was successfully saved to master as commit c0ae274f6046912107bad734834cbf65918668b6.",
"actionLog": []
}
}
Definitioner
Name | Description |
---|---|
Async |
Status för en asynkron åtgärd. |
configuration |
Identifieraren för Git-konfigurationsåtgärden. |
Error |
Fel Fältkontrakt. |
Error |
Felsvar. |
Error |
Fel på brödtextkontrakt. |
Operation |
Git-åtgärdsresultat som körs länge. |
Operation |
Logg över entiteten som skapas, uppdateras eller tas bort. |
Save |
Spara information om klientkonfigurationskontraktet. |
AsyncOperationStatus
Status för en asynkron åtgärd.
Name | Typ | Description |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
Started |
string |
|
Succeeded |
string |
configurationIdName
Identifieraren för Git-konfigurationsåtgärden.
Name | Typ | Description |
---|---|---|
configuration |
string |
ErrorFieldContract
Fel Fältkontrakt.
Name | Typ | Description |
---|---|---|
code |
string |
Felkod på egenskapsnivå. |
message |
string |
Mänsklig läsbar representation av fel på egenskapsnivå. |
target |
string |
Egenskapsnamn. |
ErrorResponse
Felsvar.
Name | Typ | Description |
---|---|---|
error.code |
string |
Tjänstdefinierad felkod. Den här koden fungerar som en understatus för HTTP-felkoden som anges i svaret. |
error.details |
Listan över ogiltiga fält som skickas i begäran, om verifieringsfel uppstår. |
|
error.message |
string |
Mänsklig läsbar representation av felet. |
ErrorResponseBody
Fel på brödtextkontrakt.
Name | Typ | Description |
---|---|---|
code |
string |
Tjänstdefinierad felkod. Den här koden fungerar som en understatus för HTTP-felkoden som anges i svaret. |
details |
Listan över ogiltiga fält som skickas i begäran, om verifieringsfel uppstår. |
|
message |
string |
Mänsklig läsbar representation av felet. |
OperationResultContract
Git-åtgärdsresultat som körs länge.
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Namnet på resursen |
properties.actionLog |
Den här egenskapen tillhandahålls endast som en del av åtgärden TenantConfiguration_Validate. Den innehåller loggen de entiteter som ska uppdateras/skapas/tas bort som en del av den TenantConfiguration_Deploy åtgärden. |
|
properties.error |
Fel på brödtextkontrakt |
|
properties.id |
string |
Åtgärdsresultatidentifierare. |
properties.resultInfo |
string |
Valfri resultatinformation. |
properties.started |
string |
Starttid för en asynkron åtgärd. Datumet överensstämmer med följande format: |
properties.status |
Status för en asynkron åtgärd. |
|
properties.updated |
string |
Senaste uppdateringstid för en asynkron åtgärd. Datumet överensstämmer med följande format: |
type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
OperationResultLogItemContract
Logg över entiteten som skapas, uppdateras eller tas bort.
Name | Typ | Description |
---|---|---|
action |
string |
Åtgärd som att skapa/uppdatera/ta bort. |
objectKey |
string |
Identifierare för entiteten som skapas/uppdateras/tas bort. |
objectType |
string |
Typen av entitetskontrakt. |
SaveConfigurationParameter
Spara information om klientkonfigurationskontraktet.
Name | Typ | Description |
---|---|---|
properties.branch |
string |
Namnet på Git-grenen där den aktuella konfigurationsögonblicksbilden ska checkas in. |
properties.force |
boolean |
Värdet om det är sant, den aktuella konfigurationsdatabasen checkas in på Git-lagringsplatsen, även om Git-lagringsplatsen har nyare ändringar som skulle skrivas över. |