ドキュメント
ホームページ Certificate Management Service 開発者リソース APIリファレンス (SSL証明書) フロー制御情報 インスタンスのサブスクリプション UpdateInstance

UpdateInstance

更新日時
Copy as MD
製品

インスタンスを更新します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API：アクションを具体的に実行するための API。

  • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

  • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cert:UpdateInstance

update

*All Resource

*

 なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例
InstanceId

string

必須

インスタンスの ID。

cas-cn-68n1mm16****
CertificateName

string

任意

インスタンスの名前。 証明書を発行する際、この値はデフォルトの証明書名として使用されます。

123
Domain

string

任意

証明書にバインドするドメイン名。 要件は次のとおりです：

  • シングルドメイン名またはワイルドカードドメイン名 (例： *.aliyundoc.com) をサポートします。

  • 複数ドメイン名をサポートします。 複数のドメイン名はコンマ (,) で区切ります。 最初のドメインによって、無料ドメインが含まれるかどうかが決まります。

重要

証明書に複数のドメイン名をバインドする場合、このパラメーターは必須です。 このパラメーターと Csr パラメーターの両方を空にすることはできません。 両方のパラメーターを設定した場合、システムは Csr の CN フィールドの値を証明書のドメイン名として使用します。

test.com
KeyAlgorithm

string

任意

証明書アルゴリズム。 デフォルト値： RSA_2048。

  • RSA_2048

  • RSA_3072

  • RSA_4096

  • ECC_256

  • SM2

RSA_2048
AutoReissue

string

任意

自動管理を有効にするかどうか。

  • enable： 有効化

  • disable： 無効化

enable
CompanyId

integer

任意

会社情報 ID。 OV 証明書および EV 証明書に必須です。 それ以外の場合、ApplyCertificate を呼び出して証明書をリクエストすることはできません。

44211
ContactIdList

array

任意

連絡先 ID のリスト。 少なくとも 1 つの連絡先を指定する必要があります。 それ以外の場合、ApplyCertificate を呼び出して証明書をリクエストすることはできません。

integer

任意

連絡先情報 ID。

123
GenerateCsrMethod

string

任意

CSR 生成メソッド。 デフォルト値： online。

  • online： システムが CSR を生成します。 Csr フィールドは無視されます。

  • upload： CSR をアップロードします。 Csr フィールドは必須です。

online
Csr

string

任意

CSR コンテンツ。 OpenSSL または Keytool を使用して CSR を生成できます。 詳細については、「CSR ファイルの作成方法」をご参照ください。

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
ValidationMethod

string

任意

証明書検証メソッド。

  • DNS： TXT レコードまたは CNAME レコードを使用した DNS 検証。

  • HTTP： ファイルベースの検証。

DNS
City

string

任意

証明書申請者の会社または組織が所在する都市。 DV 証明書の CSR を生成する際に必須です。 デフォルト値： 北京。

Beijing
Province

string

任意

会社が所在する省またはリージョン。 DV 証明書の CSR を生成する際に必須です。 デフォルト値： 北京。

Beijing
CountryCode

string

任意

証明書組織の国/地域コード。 たとえば、CN は中国を表し、US は米国を表します。 DV 証明書の CSR を生成する際に必須です。 デフォルト値： CN。

CN
ResourceGroupId

string

任意

リソースグループ ID。

rg-ae******4wia
Tags

array<object>

任意

タグのリスト。

object

任意

タグのリスト。

TagKey

string

任意

インスタンスのタグキー。 N の有効値： 1～20。 この値を指定する場合、空の文字列にすることはできません。

最大 64 文字まで使用できます。 aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

test
TagValue

string

任意

インスタンスのタグ値。 N の有効値： 1～20。 この値を指定する場合、空の文字列にすることができます。

最大 128 文字まで使用できます。 aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

test

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID。 Alibaba Cloud は、トラブルシューティングや問題の特定に役立てるために、各リクエストに一意の識別子を生成します。

0068247C-A454-5FC9-93BF-C41CBB5CD19E

例

成功レスポンス

JSONJSON

{
  "RequestId": "0068247C-A454-5FC9-93BF-C41CBB5CD19E"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。

前へ：ListInstances次へ：GetInstanceDetail