Sdílet prostřednictvím


Certificates - Create Or Update

Popis Create nebo aktualizace certifikátu.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/certificates/{name}?api-version=2023-12-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
name
path True

string

Název certifikátu.

resourceGroupName
path True

string

Název skupiny prostředků, do které prostředek patří.

Vzor regulárního výrazu: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

ID vašeho předplatného Azure Jedná se o řetězec ve formátu GUID (např. 00000000-0000-0000-0000-0000000000000000).

api-version
query True

string

Verze rozhraní API

Text požadavku

Name Vyžadováno Typ Description
location True

string

Umístění prostředku.

kind

string

Druh prostředku.

properties.canonicalName

string

CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu

properties.domainValidationMethod

string

Metoda ověření domény pro bezplatný certifikát

properties.hostNames

string[]

Názvy hostitelů, na které se certifikát vztahuje.

properties.keyVaultId

string

Key Vault ID prostředku CSM.

properties.keyVaultSecretName

string

Key Vault název tajného kódu.

properties.password

string

Heslo certifikátu.

properties.pfxBlob

string

Objekt blob Pfx.

properties.serverFarmId

string

ID prostředku přidruženého plánu App Service ve formátu:/subscriptions/{id_předplatného}/resourceGroups/{název_skupiny}/providers/Microsoft.Web/serverfarms/{appServicePlanName}.

tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

Certificate

OK.

Other Status Codes

DefaultErrorResponse

App Service chybovou odpověď.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Create Or Update Certificate

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282?api-version=2023-12-01

{
  "location": "East US",
  "properties": {
    "hostNames": [
      "ServerCert"
    ],
    "password": "<password>"
  }
}

Ukázková odpověď

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282",
  "name": "testc6282",
  "type": "Microsoft.Web/certificates",
  "location": "East US",
  "properties": {
    "friendlyName": "",
    "subjectName": "ServerCert",
    "hostNames": [
      "ServerCert"
    ],
    "issuer": "CACert",
    "issueDate": "2015-11-12T23:40:25+00:00",
    "expirationDate": "2039-12-31T23:59:59+00:00",
    "thumbprint": "FE703D7411A44163B6D32B3AD9B03E175886EBFE"
  }
}

Definice

Name Description
Certificate

Certifikát SSL pro aplikaci.

DefaultErrorResponse

App Service chybovou odpověď.

Details
Error

Model chyb.

HostingEnvironmentProfile

Specifikace App Service Environment, která se má pro tento prostředek použít.

KeyVaultSecretStatus

Stav tajného kódu Key Vault.

Certificate

Certifikát SSL pro aplikaci.

Name Typ Description
id

string

ID prostředku.

kind

string

Druh prostředku.

location

string

Umístění prostředku.

name

string

Název prostředku.

properties.canonicalName

string

CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu

properties.cerBlob

string

Nezpracované bajty .cer souboru

properties.domainValidationMethod

string

Metoda ověření domény pro bezplatný certifikát

properties.expirationDate

string

Datum vypršení platnosti certifikátu.

properties.friendlyName

string

Popisný název certifikátu

properties.hostNames

string[]

Názvy hostitelů, na které se certifikát vztahuje.

properties.hostingEnvironmentProfile

HostingEnvironmentProfile

Specifikace App Service Environment, která se má použít pro certifikát.

properties.issueDate

string

Datum vydání certifikátu.

properties.issuer

string

Vystavitel certifikátu.

properties.keyVaultId

string

Key Vault ID prostředku CSM.

properties.keyVaultSecretName

string

Key Vault název tajného kódu.

properties.keyVaultSecretStatus

KeyVaultSecretStatus

Stav tajného kódu Key Vault.

properties.password

string

Heslo certifikátu.

properties.pfxBlob

string

Objekt blob Pfx.

properties.publicKeyHash

string

Hodnota hash veřejného klíče

properties.selfLink

string

Odkaz na sebe sama.

properties.serverFarmId

string

ID prostředku přidruženého plánu App Service ve formátu:/subscriptions/{id_předplatného}/resourceGroups/{název_skupiny}/providers/Microsoft.Web/serverfarms/{appServicePlanName}.

properties.siteName

string

Název aplikace.

properties.subjectName

string

Název subjektu certifikátu.

properties.thumbprint

string

Kryptografický otisk certifikátu.

properties.valid

boolean

Je certifikát platný?

tags

object

Značky prostředků.

type

string

Typ prostředku.

DefaultErrorResponse

App Service chybovou odpověď.

Name Typ Description
error

Error

Model chyb.

Details

Name Typ Description
code

string

Standardizovaný řetězec pro programovou identifikaci chyby

message

string

Podrobný popis chyby a informace o ladění

target

string

Podrobný popis chyby a informace o ladění

Error

Model chyb.

Name Typ Description
code

string

Standardizovaný řetězec pro programovou identifikaci chyby

details

Details[]

Podrobné chyby.

innererror

string

Další informace o chybě ladění

message

string

Podrobný popis chyby a informace o ladění

target

string

Podrobný popis chyby a informace o ladění

HostingEnvironmentProfile

Specifikace App Service Environment, která se má pro tento prostředek použít.

Name Typ Description
id

string

ID prostředku App Service Environment.

name

string

Název App Service Environment.

type

string

Typ prostředku App Service Environment.

KeyVaultSecretStatus

Stav tajného kódu Key Vault.

Name Typ Description
AzureServiceUnauthorizedToAccessKeyVault

string

CertificateOrderFailed

string

ExternalPrivateKey

string

Initialized

string

KeyVaultDoesNotExist

string

KeyVaultSecretDoesNotExist

string

OperationNotPermittedOnKeyVault

string

Succeeded

string

Unknown

string

UnknownError

string

WaitingOnCertificateOrder

string