Certificates - Create Or Update

サービス:: App Service

API バージョン:: 2025-05-01

証明書の作成または更新の説明。

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

URI パラメーター

名前	/	必須	型	説明
name	path	True	string	証明書の名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字が区別されます。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
location	True	string	リソースが存在する地理的な場所
kind		string	リソースの種類。リソースがアプリの場合は、サポートされている種類の値の詳細については、https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference を参照してください。
properties.canonicalName		string	無料証明書を使用して発行される証明書の CNAME
properties.domainValidationMethod		string	無料証明書のドメイン検証の方法
properties.hostNames		string[]	証明書が適用されるホスト名。
properties.keyVaultId		string (arm-id)	Azure Key Vault Csm リソース ID。
properties.keyVaultSecretName		string	Azure Key Vault シークレット名。
properties.password		string	証明書のパスワード。
properties.pfxBlob		string (byte)	Pfx BLOB。
properties.serverFarmId		string (arm-id)	関連付けられている App Service プランのリソース ID。
tags		object	リソースタグ。

応答

名前	型	説明
200 OK	Certificate	リソース「証明書」更新操作が成功しました
Other Status Codes	DefaultErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create Or Update Certificate

要求のサンプル

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

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


import com.azure.resourcemanager.appservice.fluent.models.CertificateInner;
import java.util.Arrays;

/**
 * Samples for Certificates CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/CreateOrUpdateCertificate.json
     */
    /**
     * Sample code: Create Or Update Certificate.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void createOrUpdateCertificate(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getCertificates().createOrUpdateWithResponse(
            "testrg123", "testc6282", new CertificateInner().withLocation("East US")
                .withPassword("fakeTokenPlaceholder").withHostNames(Arrays.asList("ServerCert")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/CreateOrUpdateCertificate.json
func ExampleCertificatesClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewCertificatesClient().CreateOrUpdate(ctx, "testrg123", "testc6282", armappservice.AppCertificate{
		Location: to.Ptr("East US"),
		Properties: &armappservice.AppCertificateProperties{
			HostNames: []*string{
				to.Ptr("ServerCert"),
			},
			Password: to.Ptr("<password>"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.CertificatesClientCreateOrUpdateResponse{
	// 	AppCertificate: &armappservice.AppCertificate{
	// 		Name: to.Ptr("testc6282"),
	// 		Type: to.Ptr("Microsoft.Web/certificates"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappservice.AppCertificateProperties{
	// 			ExpirationDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2039-12-31T23:59:59+00:00"); return t}()),
	// 			FriendlyName: to.Ptr(""),
	// 			HostNames: []*string{
	// 				to.Ptr("ServerCert"),
	// 			},
	// 			IssueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-11-12T23:40:25+00:00"); return t}()),
	// 			Issuer: to.Ptr("CACert"),
	// 			SubjectName: to.Ptr("ServerCert"),
	// 			Thumbprint: to.Ptr("FE703D7411A44163B6D32B3AD9B03E175886EBFE"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

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

定義

名前	説明
Certificate	アプリの SSL 証明書。
createdByType	リソースを作成した ID の種類。
DefaultErrorResponse	App Service エラー応答。
DefaultErrorResponseError	エラーモデル。
DefaultErrorResponseErrorDetailsItem	詳細なエラー。
HostingEnvironmentProfile	このリソースに使用する App Service Environment の仕様。
KeyVaultSecretStatus	Key Vault シークレットの状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

Certificate

Object

アプリの SSL 証明書。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	リソースの種類。リソースがアプリの場合は、サポートされている種類の値の詳細については、https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference を参照してください。
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties.canonicalName	string	無料証明書を使用して発行される証明書の CNAME
properties.cerBlob	string (byte)	.cer ファイルの生バイト数
properties.domainValidationMethod	string	無料証明書のドメイン検証の方法
properties.expirationDate	string (date-time)	証明書の有効期限。
properties.friendlyName	string	証明書のフレンドリ名。
properties.hostNames	string[]	証明書が適用されるホスト名。
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	証明書に使用する App Service Environment の仕様。
properties.issueDate	string (date-time)	証明書の発行日。
properties.issuer	string	証明書の発行者。
properties.keyVaultId	string (arm-id)	Azure Key Vault Csm リソース ID。
properties.keyVaultSecretName	string	Azure Key Vault シークレット名。
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Key Vault シークレットの状態。
properties.password	string	証明書のパスワード。
properties.pfxBlob	string (byte)	Pfx BLOB。
properties.publicKeyHash	string	公開キーハッシュ。
properties.selfLink	string	セルフリンク。
properties.serverFarmId	string (arm-id)	関連付けられている App Service プランのリソース ID。
properties.siteName	string	[アプリ名]:
properties.subjectName	string	証明書のサブジェクト名。
properties.thumbprint	string	証明書の拇印。
properties.valid	boolean	証明書は有効ですか?
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags	object	リソースタグ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Object

App Service エラー応答。

名前	型	説明
error	DefaultErrorResponseError	エラーモデル。

DefaultErrorResponseError

Object

エラーモデル。

名前	型	説明
code	string	プログラムでエラーを識別するための標準化された文字列。
details	DefaultErrorResponseErrorDetailsItem[]	詳細なエラー。
innererror	string	エラーのデバッグに関する詳細情報。
message	string	詳細なエラーの説明とデバッグ情報。
target	string	詳細なエラーの説明とデバッグ情報。

DefaultErrorResponseErrorDetailsItem

Object

詳細なエラー。

名前	型	説明
code	string	プログラムでエラーを識別するための標準化された文字列。
message	string	詳細なエラーの説明とデバッグ情報。
target	string	詳細なエラーの説明とデバッグ情報。

HostingEnvironmentProfile

Object

このリソースに使用する App Service Environment の仕様。

名前	型	説明
id	string	App Service Environment のリソース ID。
name	string	App Service 環境の名前。
type	string	App Service Environment のリソースの種類。

KeyVaultSecretStatus

列挙

Key Vault シークレットの状態。

値	説明
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Certificates - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create Or Update Certificate

要求のサンプル

応答のサンプル

定義

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData