Certificates - Create Or Update

Service:

App Service

API Version:

2023-12-01

Beskrivning av Skapa eller uppdatera ett certifikat.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string	Namnet på certifikatet.
resourceGroupName	path	True	string	Namnet på resursgruppen som resursen tillhör. Regex pattern: ^[-\w\._\(\)]+[^\.]$
subscriptionId	path	True	string	ditt prenumerations-ID för Azure Det här är en GUID-formaterad sträng (t.ex. 00000000-0000-0000-0000-0000000000000000).
api-version	query	True	string	API-version

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Resursplats.
kind		string	Typ av resurs.
properties.canonicalName		string	CNAME för certifikatet som ska utfärdas via kostnadsfritt certifikat
properties.domainValidationMethod		string	Metod för domänvalidering för kostnadsfria certifikat
properties.hostNames		string[]	Värdnamn som certifikatet gäller för.
properties.keyVaultId		string	Key Vault Csm-resurs-ID.
properties.keyVaultSecretName		string	Key Vault hemligt namn.
properties.password		string	Certifikatlösenord.
properties.pfxBlob		string	Pfx-blob.
properties.serverFarmId		string	Resurs-ID för den associerade App Service plan, formaterat som: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	Certificate	OK.
Other Status Codes	DefaultErrorResponse	App Service felsvar.

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

Create Or Update Certificate

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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"
  }
}

Definitioner

Name	Description
Certificate	SSL-certifikat för en app.
DefaultErrorResponse	App Service felsvar.
Details
Error	Felmodell.
HostingEnvironmentProfile	Specifikation för en App Service-miljön som ska användas för den här resursen.
KeyVaultSecretStatus	Status för den Key Vault hemligheten.

Certificate

SSL-certifikat för en app.

Name	Typ	Description
id	string	Resurs-ID.
kind	string	Typ av resurs.
location	string	Resursplats.
name	string	Resursnamn.
properties.canonicalName	string	CNAME för certifikatet som ska utfärdas via kostnadsfritt certifikat
properties.cerBlob	string	Råbyte för .cer fil
properties.domainValidationMethod	string	Metod för domänvalidering för kostnadsfria certifikat
properties.expirationDate	string	Certifikatets förfallodatum.
properties.friendlyName	string	Eget namn på certifikatet.
properties.hostNames	string[]	Värdnamn som certifikatet gäller för.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specifikation för App Service-miljön som ska användas för certifikatet.
properties.issueDate	string	Certifikatutfärdardatum.
properties.issuer	string	Certifikatutfärdare.
properties.keyVaultId	string	Key Vault Csm-resurs-ID.
properties.keyVaultSecretName	string	Key Vault hemligt namn.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Status för den Key Vault hemligheten.
properties.password	string	Certifikatlösenord.
properties.pfxBlob	string	Pfx-blob.
properties.publicKeyHash	string	Hash för offentlig nyckel.
properties.selfLink	string	Självlänk.
properties.serverFarmId	string	Resurs-ID för den associerade App Service plan, formaterat som: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteName	string	Appnamn.
properties.subjectName	string	Certifikatets ämnesnamn.
properties.thumbprint	string	Certifikatets tumavtryck.
properties.valid	boolean	Är certifikatet giltigt?.
tags	object	Resurstaggar.
type	string	Resurstyp.

DefaultErrorResponse

App Service felsvar.

Name	Typ	Description
error	Error	Felmodell.

Details

Name	Typ	Description
code	string	Standardiserad sträng för att programmässigt identifiera felet.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

Error

Felmodell.

Name	Typ	Description
code	string	Standardiserad sträng för att programmässigt identifiera felet.
details	Details[]	Detaljerade fel.
innererror	string	Mer information om felsökningsfel.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

HostingEnvironmentProfile

Specifikation för en App Service-miljön som ska användas för den här resursen.

Name	Typ	Description
id	string	Resurs-ID för App Service-miljön.
name	string	Namnet på App Service-miljön.
type	string	Resurstyp för App Service-miljön.

KeyVaultSecretStatus

Status för den Key Vault hemligheten.

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