Api Management Service - Restore
Stellt eine Sicherung eines API Management Diensts wieder her, der mit dem vorgang ApiManagementService_Backup für den aktuellen Dienst erstellt wurde. 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}/restore?api-version=2022-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
service
|
path | True |
string |
Der Name des API Management-Diensts. RegEx-Muster: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
backupName | True |
string |
Der Name der sicherungsdatei, die erstellt/abgerufen werden soll. |
containerName | True |
string |
Der Name des Blobcontainers (der zum Platzieren/Abrufen der Sicherung verwendet wird). |
storageAccount | True |
string |
Der Name des Azure-Speicherkontos (wird zum Platzieren/Abrufen der Sicherung verwendet). |
accessKey |
string |
Zugriffsschlüssel für das Speicherkonto Nur erforderlich, wenn |
|
accessType |
Der Typ des Zugriffs, der für das Speicherkonto verwendet werden soll. |
||
clientId |
string |
Die Client-ID der vom Benutzer zugewiesenen verwalteten Identität. Nur erforderlich, wenn |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Sicherung wurde erfolgreich im API Management-Dienst wiederhergestellt. |
|
202 Accepted |
Akzeptiert: Der Speicherortheader enthält die URL, unter der die status des zeitintensiven Vorgangs überprüft werden kann. Header location: string |
|
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
ApiManagementRestoreService
Beispielanforderung
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/restore?api-version=2022-08-01
{
"storageAccount": "teststorageaccount",
"containerName": "backupContainer",
"backupName": "apimService1backup_2017_03_19",
"accessType": "AccessKey",
"accessKey": "**************************************************"
}
Beispiel für eine Antwort
location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2022-08-01
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"tags": {
"tag1": "value1",
"tag2": "value2",
"tag3": "value3"
},
"location": "West US",
"etag": "AAAAAAACXok=",
"properties": {
"publisherEmail": "apim@autorestsdk.com",
"publisherName": "autorestsdk",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2019-12-18T06:26:20.3348609Z",
"gatewayUrl": "https://apimService1.azure-api.net",
"gatewayRegionalUrl": "https://apimService1-westus-01.regional.azure-api.net",
"portalUrl": "https://apimService1.portal.azure-api.net",
"developerPortalUrl": "https://apimService1.developer.azure-api.net",
"managementApiUrl": "https://apimService1.management.azure-api.net",
"scmUrl": "https://apimService1.scm.azure-api.net",
"hostnameConfigurations": [
{
"type": "Proxy",
"hostName": "apimService1.azure-api.net",
"negotiateClientCertificate": false,
"defaultSslBinding": false
},
{
"type": "Proxy",
"hostName": "gateway1.msitesting.net",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2036-01-01T07:00:00+00:00",
"thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
"subject": "CN=*.msitesting.net"
},
"defaultSslBinding": true
},
{
"type": "Management",
"hostName": "mgmt.msitesting.net",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2036-01-01T07:00:00+00:00",
"thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
"subject": "CN=*.msitesting.net"
},
"defaultSslBinding": false
},
{
"type": "Portal",
"hostName": "portal1.msitesting.net",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2036-01-01T07:00:00+00:00",
"thumbprint": "8E989XXXXXXXXXXXXXXXXB9C2C91F1D174FDB3A2",
"subject": "CN=*.msitesting.net"
},
"defaultSslBinding": false
}
],
"publicIPAddresses": [
"13.91.32.113"
],
"additionalLocations": [
{
"location": "East US",
"sku": {
"name": "Premium",
"capacity": 1
},
"publicIPAddresses": [
"23.101.138.153"
],
"gatewayRegionalUrl": "https://apimService1-eastus-01.regional.azure-api.net",
"disableGateway": true
}
],
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
},
"virtualNetworkType": "None",
"disableGateway": false,
"apiVersionConstraint": {
"minApiVersion": "2019-01-01"
}
},
"sku": {
"name": "Premium",
"capacity": 1
}
}
Definitionen
Name | Beschreibung |
---|---|
Access |
Die Art des Zugriffs, der für das Speicherkonto verwendet werden soll. |
Additional |
Beschreibung eines zusätzlichen API Management Ressourcenstandorts. |
Api |
Parameter, die für die Sicherung/Wiederherstellung eines API Management-Dienstvorgangs bereitgestellt werden. |
Api |
Identitätseigenschaften der Api Management-Dienstressource. |
Api |
Eine einzelne API Management Dienstressource in "List" oder "Get response". |
Api |
API Management SKU-Eigenschaften der Dienstressource. |
Apim |
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. |
Api |
Apis-Versionseinschränkung der Steuerungsebene für den API Management-Dienst. |
Arm |
Ein Wrapper für eine ARM-Ressourcen-ID |
Certificate |
Zertifikatkonfiguration, die aus nicht vertrauenswürdigen Zwischenstufen und Stammzertifikaten besteht. |
Certificate |
SSL-Zertifikatinformationen. |
Certificate |
Zertifikatquelle. |
Certificate |
Zertifikatstatus. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Fehlerfeldvertrag. |
Error |
Fehlerantwort. |
Hostname |
Konfiguration des benutzerdefinierten Hostnamens. |
Hostname |
Hostnamentyp. |
Nat |
Die Eigenschaft kann verwendet werden, um NAT Gateway für diesen API Management Dienst zu aktivieren. |
Platform |
Compute Platform Version, die den Dienst ausführt. |
Private |
Die verbindung mit dem privaten Endpunkt status. |
Private |
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter. |
Public |
Gibt an, ob für diesen API Management Dienst der Zugriff auf öffentliche Endpunkte zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein. Bei "Deaktiviert" sind private Endpunkte die exklusive Zugriffsmethode. Der Standardwert ist "Aktiviert". |
Remote |
Verbindungsressource für private Remoteendpunkte. |
Sku |
Name der Sku. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
User |
|
Virtual |
Konfiguration eines virtuellen Netzwerks, in dem API Management Dienst bereitgestellt wird. |
Virtual |
Der VPN-Typ, in dem API Management Dienst konfiguriert werden muss. None (Standardwert) bedeutet, dass der API Management-Dienst nicht Teil eines Virtual Network ist. Extern bedeutet, dass die API Management Bereitstellung innerhalb eines Virtual Network mit einem Endpunkt mit Internetzugriff eingerichtet ist, und Intern bedeutet, dass API Management Die Bereitstellung wird in einer Virtual Network eingerichtet, die nur einen intranetorientierten Endpunkt aufweist. |
AccessType
Die Art des Zugriffs, der für das Speicherkonto verwendet werden soll.
Name | Typ | Beschreibung |
---|---|---|
AccessKey |
string |
Verwenden Sie den Zugriffsschlüssel. |
SystemAssignedManagedIdentity |
string |
Verwenden Sie systemseitig zugewiesene verwaltete Identität. |
UserAssignedManagedIdentity |
string |
Verwenden Sie benutzerseitig zugewiesene verwaltete Identität. |
AdditionalLocation
Beschreibung eines zusätzlichen API Management Ressourcenstandorts.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
disableGateway |
boolean |
False |
Die Eigenschaft gilt nur für einen Api Management-Dienst, der an mehreren Standorten bereitgestellt wird. Dies kann verwendet werden, um das Gateway an diesem zusätzlichen Speicherort zu deaktivieren. |
gatewayRegionalUrl |
string |
Gateway-URL des API Management-Diensts in der Region. |
|
location |
string |
Der Standortname der zusätzlichen Region unter Den Azure-Rechenzentrumsregionen. |
|
natGatewayState | Disabled |
Die Eigenschaft kann verwendet werden, um NAT Gateway für diesen API Management Dienst zu aktivieren. |
|
outboundPublicIPAddresses |
string[] |
Präfixe für ausgehende öffentliche IPV4-Adressen, die dem von NAT Gateway bereitgestellten Dienst zugeordnet sind. Nur für Premium-SKU auf stv2-Plattform verfügbar. |
|
platformVersion |
Compute Platform Version, die den Dienst ausführt. |
||
privateIPAddresses |
string[] |
Private statische IP-Adressen des API Management-Diensts, der in einem internen Virtual Network an einem bestimmten zusätzlichen Speicherort bereitgestellt wird. Verfügbar nur für die Basic-, Standard-, Premium- und Isolierte SKU. |
|
publicIPAddresses |
string[] |
Öffentliche statische Lastenausgleichs-IP-Adressen des API Management-Diensts am zusätzlichen Speicherort. Verfügbar nur für die Basic-, Standard-, Premium- und Isolierte SKU. |
|
publicIpAddressId |
string |
Öffentliche Standard-SKU-IP-V4-basierte IP-Adresse, die Virtual Network bereitgestellten Diensts am Standort zugeordnet werden soll. Wird nur für premium-SKU unterstützt, die in Virtual Network bereitgestellt wird. |
|
sku |
SKU-Eigenschaften des API Management-Diensts. |
||
virtualNetworkConfiguration |
Virtuelle Netzwerkkonfiguration für den Standort. |
||
zones |
string[] |
Eine Liste von Verfügbarkeitszonen, die angibt, wo die Ressource herkommen muss. |
ApiManagementServiceBackupRestoreParameters
Parameter, die für die Sicherung/Wiederherstellung eines API Management-Dienstvorgangs bereitgestellt werden.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
accessKey |
string |
Zugriffsschlüssel für das Speicherkonto Nur erforderlich, wenn |
|
accessType | AccessKey |
Der Typ des Zugriffs, der für das Speicherkonto verwendet werden soll. |
|
backupName |
string |
Der Name der sicherungsdatei, die erstellt/abgerufen werden soll. |
|
clientId |
string |
Die Client-ID der vom Benutzer zugewiesenen verwalteten Identität. Nur erforderlich, wenn |
|
containerName |
string |
Der Name des Blobcontainers (der zum Platzieren/Abrufen der Sicherung verwendet wird). |
|
storageAccount |
string |
Der Name des Azure-Speicherkontos (wird zum Platzieren/Abrufen der Sicherung verwendet). |
ApiManagementServiceIdentity
Identitätseigenschaften der Api Management-Dienstressource.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Die Prinzipal-ID der Identität. |
tenantId |
string |
Die Clientmandanten-ID der Identität. |
type |
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. |
|
userAssignedIdentities |
<string,
User |
Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Verweise auf das Benutzeridentitätswörterbuch sind ARM-Ressourcen-IDs im Format "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ApiManagementServiceResource
Eine einzelne API Management Dienstressource in "List" oder "Get response".
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
etag |
string |
ETag der Ressource. |
|
id |
string |
Ressourcen-ID |
|
identity |
Verwaltete Dienstidentität des Api Management-Diensts. |
||
location |
string |
Ressourcenspeicherort |
|
name |
string |
Name der Ressource. |
|
properties.additionalLocations |
Zusätzliche Rechenzentrumsstandorte des API Management-Diensts. |
||
properties.apiVersionConstraint |
Versionseinschränkung der Steuerungsebenen-API für den API Management-Dienst. |
||
properties.certificates |
Liste der Zertifikate, die im API Management-Dienst installiert werden müssen. Die maximale Anzahl von unterstützten Zertifikaten, die installiert werden können, beträgt 10. |
||
properties.createdAtUtc |
string |
Erstellungsdatum des API Management-Diensts. Das Datum entspricht dem folgenden Format: |
|
properties.customProperties |
object |
Benutzerdefinierte Eigenschaften des API Management-Diensts. |
|
properties.developerPortalUrl |
string |
DEveloper Portal-Endpunkt-URL des API Management-Diensts. |
|
properties.disableGateway |
boolean |
False |
Die Eigenschaft ist nur für einen Api Management-Dienst gültig, der an mehreren Standorten bereitgestellt wird. Dies kann verwendet werden, um das Gateway in master Region zu deaktivieren. |
properties.enableClientCertificate |
boolean |
False |
Eigenschaft, die nur für den Verbrauchs-SKU-Dienst verwendet werden soll. Dadurch wird erzwungen, dass bei jeder Anforderung an das Gateway ein Clientzertifikat angezeigt wird. Dies ermöglicht auch die Authentifizierung des Zertifikats in der Richtlinie auf dem Gateway. |
properties.gatewayRegionalUrl |
string |
Gateway-URL des API Management-Diensts in der Standardregion. |
|
properties.gatewayUrl |
string |
Gateway-URL des API Management-Diensts. |
|
properties.hostnameConfigurations |
Konfiguration des benutzerdefinierten Hostnamens des API Management-Diensts. |
||
properties.managementApiUrl |
string |
Verwaltungs-API-Endpunkt-URL des API Management-Diensts. |
|
properties.natGatewayState | Disabled |
Die -Eigenschaft kann verwendet werden, um NAT Gateway für diesen API Management-Dienst zu aktivieren. |
|
properties.notificationSenderEmail |
string |
Email Adresse, von der die Benachrichtigung gesendet wird. |
|
properties.outboundPublicIPAddresses |
string[] |
Präfixe für ausgehende öffentliche IPV4-Adressen, die dem bereitgestellten NAT Gateway-Dienst zugeordnet sind. Nur für Premium-SKU auf stv2-Plattform verfügbar. |
|
properties.platformVersion |
Computeplattformversion, die den Dienst an diesem Speicherort ausführt. |
||
properties.portalUrl |
string |
Endpunkt-URL des API Management-Diensts des Herausgeberportals. |
|
properties.privateEndpointConnections |
Liste der Privaten Endpunktverbindungen dieses Diensts. |
||
properties.privateIPAddresses |
string[] |
Ip-Adressen mit privatem statischem Lastenausgleich des API Management-Diensts in der primären Region, die in einem internen Virtual Network bereitgestellt wird. Nur für Basic-, Standard-, Premium- und Isolierte SKU verfügbar. |
|
properties.provisioningState |
string |
Der aktuelle Bereitstellungsstatus des API Management Dienst, der wie folgt aussehen kann: Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted. |
|
properties.publicIPAddresses |
string[] |
Öffentliche ip-Adressen mit statischem Lastenausgleich des API Management-Diensts in der primären Region. Nur für Basic-, Standard-, Premium- und Isolierte SKU verfügbar. |
|
properties.publicIpAddressId |
string |
Public Standard SKU IP V4-basierte IP-Adresse, die Virtual Network bereitgestellten Dienst in der Region zugeordnet werden soll. Wird nur für Entwickler- und Premium-SKU unterstützt, die in Virtual Network bereitgestellt wird. |
|
properties.publicNetworkAccess |
Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen API Management-Dienst zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss "Aktiviert" oder "Deaktiviert" sein. Bei "Disabled" sind private Endpunkte die exklusive Zugriffsmethode. Der Standardwert ist "Enabled". |
||
properties.publisherEmail |
string |
Herausgeber-E-Mail. |
|
properties.publisherName |
string |
Herausgebername. |
|
properties.restore |
boolean |
False |
Wiederherstellen des Api Management-Diensts, wenn er zuvor vorläufig gelöscht wurde. Wenn dieses Flag angegeben und auf True festgelegt ist, werden alle anderen Eigenschaften ignoriert. |
properties.scmUrl |
string |
SCM-Endpunkt-URL des API Management-Diensts. |
|
properties.targetProvisioningState |
string |
Der Bereitstellungsstatus des API Management Diensts, auf den der für den Dienst gestartete Vorgang mit langer Ausführungszeit ausgerichtet ist. |
|
properties.virtualNetworkConfiguration |
Virtuelle Netzwerkkonfiguration des API Management-Diensts. |
||
properties.virtualNetworkType | None |
Der VPN-Typ, in dem API Management Dienst konfiguriert werden muss. None (Standardwert) bedeutet, dass der API Management-Dienst nicht Teil eines Virtual Network ist. Extern bedeutet, dass die API Management Bereitstellung innerhalb einer Virtual Network eingerichtet ist, die über einen Endpunkt mit Internetzugriff verfügt, und Intern bedeutet, dass API Management die Bereitstellung wird in einem Virtual Network eingerichtet, der nur über einen Intranetendpunkt verfügt. |
|
sku |
SKU-Eigenschaften des API Management-Diensts. |
||
systemData |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
||
tags |
object |
Ressourcentags. |
|
type |
string |
Der Ressourcentyp für API Management Ressource ist auf Microsoft.ApiManagement festgelegt. |
|
zones |
string[] |
Eine Liste der Verfügbarkeitszonen, die angibt, wo die Ressource herkommen muss. |
ApiManagementServiceSkuProperties
API Management SKU-Eigenschaften der Dienstressource.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Kapazität der SKU (Anzahl der bereitgestellten Einheiten der SKU). Für Verbrauch muss die SKU-Kapazität als 0 angegeben werden. |
name |
Name der SKU. |
ApimIdentityType
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
ApiVersionConstraint
Apis-Versionseinschränkung der Steuerungsebene für den API Management-Dienst.
Name | Typ | Beschreibung |
---|---|---|
minApiVersion |
string |
Beschränken Sie API-Aufrufe der Steuerungsebene für API Management Dienst, deren Version gleich oder höher ist als dieser Wert. |
ArmIdWrapper
Ein Wrapper für eine ARM-Ressourcen-ID
Name | Typ | Beschreibung |
---|---|---|
id |
string |
CertificateConfiguration
Zertifikatkonfiguration, die aus nicht vertrauenswürdigen Zwischenstufen und Stammzertifikaten besteht.
Name | Typ | Beschreibung |
---|---|---|
certificate |
Zertifikatinformationen. |
|
certificatePassword |
string |
Zertifikatkennwort. |
encodedCertificate |
string |
Base64-codiertes Zertifikat. |
storeName |
enum:
|
Der Zertifikatspeicherspeicherort System.Security.Cryptography.x509certificates.StoreName. Nur Root und CertificateAuthority sind gültige Speicherorte. |
CertificateInformation
SSL-Zertifikatinformationen.
Name | Typ | Beschreibung |
---|---|---|
expiry |
string |
Ablaufdatum des Zertifikats. Das Datum entspricht dem folgenden Format: |
subject |
string |
Antragsteller des Zertifikats. |
thumbprint |
string |
Fingerabdruck des Zertifikats |
CertificateSource
Zertifikatquelle.
Name | Typ | Beschreibung |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
KeyVault |
string |
|
Managed |
string |
CertificateStatus
Zertifikatstatus.
Name | Typ | Beschreibung |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
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 in der Anforderung gesendet werden, im Falle eines Validierungsfehlers. |
|
error.message |
string |
Lesbare Darstellung des Fehlers. |
HostnameConfiguration
Konfiguration des benutzerdefinierten Hostnamens.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
certificate |
Zertifikatinformationen. |
||
certificatePassword |
string |
Zertifikatkennwort. |
|
certificateSource |
Zertifikatquelle. |
||
certificateStatus |
Zertifikatstatus. |
||
defaultSslBinding |
boolean |
False |
Geben Sie true an, um das diesem Hostnamen zugeordnete Zertifikat als Standard-SSL-Zertifikat einzurichten. Wenn ein Client den SNI-Header nicht sendet, wird dies das Zertifikat sein, das angefragt wird. Die Eigenschaft ist nützlich, wenn für einen Dienst mehrere benutzerdefinierte Hostnamen aktiviert sind und er sich für das Standard-SSL-Zertifikat entscheiden muss. Die Einstellung wird nur auf den Hostnamentyp des Gateways angewendet. |
encodedCertificate |
string |
Base64-codiertes Zertifikat. |
|
hostName |
string |
Hostname, der für den Api Management-Dienst konfiguriert werden soll. |
|
identityClientId |
string |
Client-Id für system- oder benutzerseitig zugewiesene verwaltete Identität, wie von Azure AD generiert, die GET-Zugriff auf den keyVault mit dem SSL-Zertifikat hat. |
|
keyVaultId |
string |
Url zum KeyVault-Geheimnis, das das Ssl-Zertifikat enthält. Wenn eine absolute URL mit version angegeben wird, funktioniert das automatische Aktualisieren des SSL-Zertifikats nicht. Dazu muss der Api Management-Dienst mit aka.ms/apimmsi konfiguriert werden. Das Geheimnis sollte vom Typ application/x-pkcs12 sein. |
|
negotiateClientCertificate |
boolean |
False |
Geben Sie true an, um immer das Clientzertifikat für den Hostnamen auszuhandeln. Der Standardwert ist false. |
type |
Hostnamentyp. |
HostnameType
Hostnamentyp.
Name | Typ | Beschreibung |
---|---|---|
DeveloperPortal |
string |
|
Management |
string |
|
Portal |
string |
|
Proxy |
string |
|
Scm |
string |
NatGatewayState
Die Eigenschaft kann verwendet werden, um NAT Gateway für diesen API Management Dienst zu aktivieren.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
Nat Gateway ist für den Dienst deaktiviert. |
Enabled |
string |
Nat Gateway ist für den Dienst aktiviert. |
PlatformVersion
Compute Platform Version, die den Dienst ausführt.
Name | Typ | Beschreibung |
---|---|---|
mtv1 |
string |
Plattform, auf der der Dienst auf einer Mehrinstanzen-V1-Plattform ausgeführt wird. |
stv1 |
string |
Plattform, auf der der Dienst auf einer Einzelmandanten-V1-Plattform ausgeführt wird. |
stv2 |
string |
Plattform, auf der der Dienst auf einer Einzelmandanten-V2-Plattform ausgeführt wird. |
undetermined |
string |
Die Plattformversion kann nicht bestimmt werden, da die Computeplattform nicht bereitgestellt wird. |
PrivateEndpointServiceConnectionStatus
Die verbindung mit dem privaten Endpunkt status.
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter.
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern. |
description |
string |
Der Grund für die Genehmigung/Ablehnung der Verbindung. |
status |
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde. |
PublicNetworkAccess
Gibt an, ob für diesen API Management Dienst der Zugriff auf öffentliche Endpunkte zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein. Bei "Deaktiviert" sind private Endpunkte die exklusive Zugriffsmethode. Der Standardwert ist "Aktiviert".
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RemotePrivateEndpointConnectionWrapper
Verbindungsressource für private Remoteendpunkte.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Verbindungsressourcen-ID des privaten Endpunkts |
name |
string |
Verbindungsname des privaten Endpunkts |
properties.groupIds |
string[] |
Alle Gruppen-IDs. |
properties.privateEndpoint |
Die Ressource des privaten Endpunkts. |
|
properties.privateLinkServiceConnectionState |
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter. |
|
properties.provisioningState |
string |
Der Bereitstellungsstatus der Verbindungsressource des privaten Endpunkts. |
type |
string |
Ressourcentyp für private Endpunktverbindungen |
SkuType
Name der Sku.
Name | Typ | Beschreibung |
---|---|---|
Basic |
string |
Grundlegende SKU von Api Management. |
Consumption |
string |
Verbrauchs-SKU von Api Management. |
Developer |
string |
Entwickler-SKU von Api Management. |
Isolated |
string |
Isolierte SKU von Api Management. |
Premium |
string |
Premium-SKU von Api Management. |
Standard |
string |
Standard-SKU von Api Management. |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
UserIdentityProperties
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Client-ID der benutzerseitig zugewiesenen Identität. |
principalId |
string |
Die Prinzipal-ID der benutzerseitig zugewiesenen Identität. |
VirtualNetworkConfiguration
Konfiguration eines virtuellen Netzwerks, in dem API Management Dienst bereitgestellt wird.
Name | Typ | Beschreibung |
---|---|---|
subnetResourceId |
string |
Die vollständige Ressourcen-ID eines Subnetzes in einem virtuellen Netzwerk zum Bereitstellen des API Management Diensts. |
subnetname |
string |
Der Name des Teilnetzes. |
vnetid |
string |
Die ID des virtuellen Netzwerks. Dies ist in der Regel eine GUID. Erwarten Sie standardmäßig eine NULL-GUID. |
VirtualNetworkType
Der VPN-Typ, in dem API Management Dienst konfiguriert werden muss. None (Standardwert) bedeutet, dass der API Management-Dienst nicht Teil eines Virtual Network ist. Extern bedeutet, dass die API Management Bereitstellung innerhalb eines Virtual Network mit einem Endpunkt mit Internetzugriff eingerichtet ist, und Intern bedeutet, dass API Management Die Bereitstellung wird in einer Virtual Network eingerichtet, die nur einen intranetorientierten Endpunkt aufweist.
Name | Typ | Beschreibung |
---|---|---|
External |
string |
Der Dienst ist Teil von Virtual Network und über das Internet zugänglich. |
Internal |
string |
Der Dienst ist Teil von Virtual Network und nur innerhalb des virtuellen Netzwerks zugänglich. |
None |
string |
Der Dienst ist nicht Teil eines Virtual Network. |