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
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

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

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 auf AccessKeyfestgelegt ist.

accessType

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 accessType auf UserAssignedManagedIdentityfestgelegt ist.

Antworten

Name Typ Beschreibung
200 OK

ApiManagementServiceResource

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

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

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
AccessType

Die Art des Zugriffs, der für das Speicherkonto verwendet werden soll.

AdditionalLocation

Beschreibung eines zusätzlichen API Management Ressourcenstandorts.

ApiManagementServiceBackupRestoreParameters

Parameter, die für die Sicherung/Wiederherstellung eines API Management-Dienstvorgangs bereitgestellt werden.

ApiManagementServiceIdentity

Identitätseigenschaften der Api Management-Dienstressource.

ApiManagementServiceResource

Eine einzelne API Management Dienstressource in "List" oder "Get response".

ApiManagementServiceSkuProperties

API Management SKU-Eigenschaften der Dienstressource.

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.

ApiVersionConstraint

Apis-Versionseinschränkung der Steuerungsebene für den API Management-Dienst.

ArmIdWrapper

Ein Wrapper für eine ARM-Ressourcen-ID

CertificateConfiguration

Zertifikatkonfiguration, die aus nicht vertrauenswürdigen Zwischenstufen und Stammzertifikaten besteht.

CertificateInformation

SSL-Zertifikatinformationen.

CertificateSource

Zertifikatquelle.

CertificateStatus

Zertifikatstatus.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorFieldContract

Fehlerfeldvertrag.

ErrorResponse

Fehlerantwort.

HostnameConfiguration

Konfiguration des benutzerdefinierten Hostnamens.

HostnameType

Hostnamentyp.

NatGatewayState

Die Eigenschaft kann verwendet werden, um NAT Gateway für diesen API Management Dienst zu aktivieren.

PlatformVersion

Compute Platform Version, die den Dienst ausführt.

PrivateEndpointServiceConnectionStatus

Die verbindung mit dem privaten Endpunkt status.

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter.

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".

RemotePrivateEndpointConnectionWrapper

Verbindungsressource für private Remoteendpunkte.

SkuType

Name der Sku.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

UserIdentityProperties
VirtualNetworkConfiguration

Konfiguration eines virtuellen Netzwerks, in dem API Management Dienst bereitgestellt wird.

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.

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

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

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

ApiManagementServiceSkuProperties

SKU-Eigenschaften des API Management-Diensts.

virtualNetworkConfiguration

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 auf AccessKeyfestgelegt ist.

accessType

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 accessType auf UserAssignedManagedIdentityfestgelegt ist.

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

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.

userAssignedIdentities

<string,  UserIdentityProperties>

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

ApiManagementServiceIdentity

Verwaltete Dienstidentität des Api Management-Diensts.

location

string

Ressourcenspeicherort

name

string

Name der Ressource.

properties.additionalLocations

AdditionalLocation[]

Zusätzliche Rechenzentrumsstandorte des API Management-Diensts.

properties.apiVersionConstraint

ApiVersionConstraint

Versionseinschränkung der Steuerungsebenen-API für den API Management-Dienst.

properties.certificates

CertificateConfiguration[]

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: yyyy-MM-ddTHH:mm:ssZ gemäß der ISO 8601-Norm.

properties.customProperties

object

Benutzerdefinierte Eigenschaften des API Management-Diensts.
Durch die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 wird die TLS_RSA_WITH_3DES_EDE_CBC_SHA für alle TLS(1.0, 1.1 und 1.2) deaktiviert.
Die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 kann verwendet werden, um nur TLS 1.1 zu deaktivieren.
Die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 kann verwendet werden, um TLS 1.0 für einen API Management-Dienst zu deaktivieren.
Die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11 kann verwendet werden, um nur TLS 1.1 für die Kommunikation mit Back-Ends zu deaktivieren.
Die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10 kann verwendet werden, um TLS 1.0 für die Kommunikation mit Back-Ends zu deaktivieren.
Die Einstellung Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2 kann verwendet werden, um das HTTP2-Protokoll für einen API Management-Dienst zu aktivieren.
Wenn Sie keine dieser Eigenschaften beim PATCH-Vorgang angeben, werden die Werte der ausgelassenen Eigenschaften auf die Standardwerte zurückgesetzt. Für alle Einstellungen mit Ausnahme von Http2 ist True der Standardwert, wenn der Dienst am oder vor dem 1. April 2018 erstellt wurde und False andernfalls. Der Standardwert der Http2-Einstellung ist False.

Sie können jede der folgenden Verschlüsselungen mithilfe der Einstellungen Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]deaktivieren: TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA256, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA. Beispiel Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256: :false. Der Standardwert ist true für sie.
Hinweis: Die folgenden Verschlüsselungen können nicht deaktiviert werden, da sie für interne Plattformkomponenten erforderlich sind: TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

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

HostnameConfiguration[]

Konfiguration des benutzerdefinierten Hostnamens des API Management-Diensts.

properties.managementApiUrl

string

Verwaltungs-API-Endpunkt-URL des API Management-Diensts.

properties.natGatewayState

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

PlatformVersion

Computeplattformversion, die den Dienst an diesem Speicherort ausführt.

properties.portalUrl

string

Endpunkt-URL des API Management-Diensts des Herausgeberportals.

properties.privateEndpointConnections

RemotePrivateEndpointConnectionWrapper[]

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

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

VirtualNetworkConfiguration

Virtuelle Netzwerkkonfiguration des API Management-Diensts.

properties.virtualNetworkType

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

ApiManagementServiceSkuProperties

SKU-Eigenschaften des API Management-Diensts.

systemData

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

SkuType

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

CertificateInformation

Zertifikatinformationen.

certificatePassword

string

Zertifikatkennwort.

encodedCertificate

string

Base64-codiertes Zertifikat.

storeName enum:
  • CertificateAuthority
  • Root

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: yyyy-MM-ddTHH:mm:ssZ gemäß der ISO 8601-Norm.

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

ErrorFieldContract[]

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

CertificateInformation

Zertifikatinformationen.

certificatePassword

string

Zertifikatkennwort.

certificateSource

CertificateSource

Zertifikatquelle.

certificateStatus

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

HostnameType

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

PrivateEndpointServiceConnectionStatus

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

ArmIdWrapper

Die Ressource des privaten Endpunkts.

properties.privateLinkServiceConnectionState

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

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

createdByType

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.