すべてのプロダクト
Search

このプロダクト

    Global Accelerator:DissociateAdditionalCertificatesFromListener

    ドキュメントセンター

    Global Accelerator:DissociateAdditionalCertificatesFromListener

    最終更新日:Dec 14, 2025

    HTTPS リスナーから追加証明書の関連付けを解除します。

    操作説明

    説明

    • DissociateAdditionalCertificatesFromListener は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返しますが、この操作はシステムのバックグラウンドで実行されています。DescribeListener 操作を呼び出して、HTTPS リスナーの状態をクエリできます。

      • リスナーが updating 状態の場合、追加証明書がリスナーから関連付け解除中であることを示します。この場合、クエリ操作のみ実行できます。

      • リスナーが active 状態の場合、追加証明書がリスナーから関連付け解除されたことを示します。

    • 特定の期間内に、同じ Global Accelerator (GA) インスタンスに対して DissociateAdditionalCertificatesFromListener 操作を繰り返し呼び出すことはできません。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ga:DissociateAdditionalCertificatesFromListener

    update

    *Listener

    acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    GA インスタンスがデプロイされているリージョンの ID。値を cn-hangzhou に設定します。

    cn-hangzhou
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークンです。

    クライアントを使用して値を生成できますが、すべてのリクエストで一意である必要があります。ClientToken には ASCII 文字のみを含めることができます。

    説明

    このパラメーターを設定しない場合、ClientToken は RequestId の値に設定されます。RequestId の値は、API リクエストごとに異なる場合があります。

    123e4567-e89b-12d3-a456-426655440000
    AcceleratorId

    string

    必須

    GA インスタンスの ID。

    ga-bp1odcab8tmno0hdq****
    ListenerId

    string

    必須

    リスナーの ID。

    lsr-bp1bpn0kn908w4nbw****
    Domains

    array

    必須

    追加証明書に関連付けられているドメイン名。

    各リクエストで最大 10 個のドメイン名を指定できます。

    string

    必須

    追加証明書に関連付けられているドメイン名。

    各リクエストで最大 10 個のドメイン名を指定できます。

    example.com

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストの ID。

    6FEA0CF3-D3B9-43E5-A304-D217037876A8

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 AlreadyInBandwidthPackage.Accelerator The accelerated instance is already in the bandwidth package. The accelerated instance is already in the bandwidth package.
    400 BandwidthIllegal.BandwidthPackage The bandwidth of the basic bandwidth package must be lower than or equal to the bandwidth of the cross-domain bandwidth package. The bandwidth of the basic bandwidth package must be lower than or equal to the bandwidth of the cross-domain bandwidth package.
    400 BindExist.Accelerator The accelerated instance is already bound to a bandwidth package. The accelerated instance is already bound to a bandwidth package.
    400 BindExist.BandwidthPackage The bandwidth package is already bound. The bandwidth package is already bound.
    400 BindExist.EndPointGroup The endpoint group %s contains binding.
    400 EndPointGroupTypeIllegal.EndpointGroup The endpoint group type is illegal.
    400 EndPointRequestProtocolIllegal.EndpointGroup The endpoint group request protocol is illegal.
    400 Exist.EndpointGroup The endpoint group already exists.
    400 Exist.ForwardingRule The forwarding rule already exists.
    400 Exist.IpSet The IpSet already exists. The IpSet already exists.
    400 Exist.Listener The listener already exists. The listener already exists.
    400 Exist.VirtualEndpointGroup A virtual endpoint group already exists.
    400 GaSpecExceeded.IpSet The number of IpSet exceeds the specification of the GA instance. The number of IpSet exceeds the specification of the GA instance.
    400 GreaterThanGa.IpSetBandwidth The total bandwidth for IpSet exceeds the total bandwidth of the GA instance. The total bandwidth for IpSet exceeds the total bandwidth of the GA instance.
    400 IllegalBandwidth.IpSet The bandwidth of IpSet is invalid. The bandwidth of IpSet is invalid.
    400 IllegalParameter.BandwidthType The parameter BandwidthType is illegal.
    400 IllegalParameter.Spec The specified Spec is invalid. The specified Spec is invalid.
    400 IllegalParameter.Type The specified Type is invalid. The specified Type is invalid.
    400 MissingParameter.BandwidthType You must specify BandwidthType. You must specify BandwidthType.
    400 NoPermission.EnableHealthCheck You do not have permission to enable health check.
    400 NoPermission.GaDdosRoleSession You are not authorized to perform the operation.
    400 NoPermission.VpcEndpoint You are not authorized to perform the operation.
    400 NotActive.IpSet The state of IpSet is not active. The state of IpSet is not active.
    400 NotActive.Listener The state of the listener is not active. The state of the listener is not active.
    400 NotExist.Accelerator The accelerated instance does not exist. The accelerated instance does not exist.
    400 NotExist.BandwidthPackage The bandwidth package does not exist. The bandwidth package does not exist.
    400 NotExist.BasicBandwidthPackage You must specify the basic bandwidth package. You must specify the basic bandwidth package.
    400 NotExist.BusinessRegion The business region does not exist. The business region does not exist.
    400 NotExist.EndPointGroup The endpoint group does not exist. The endpoint group does not exist.
    400 NotExist.IpSet The IpSet does not exist. The IpSet does not exist.
    400 NotExist.IpSets The IpSet does not exist. The IpSet does not exist.
    400 NotExist.Listener The listener does not exist. The listener does not exist.
    400 NotExist.ListenerPort The listening port %s does not exist.
    400 NotInBandwidthPackage.Accelerator The accelerated instance is not in the bandwidth package. The accelerated instance is not in the bandwidth package.
    400 PortConflict.Listener The listener port configuration is in conflict. The listener port configuration is in conflict.
    400 PortRangeIllegal.Count The hugePort listener only supports one port range.
    400 PortRangeIllegal.Listener The specified listener port range is invalid. The specified listener port range is invalid.
    400 PortRanges.MustOne The portRanges must be one for HTTPS and HTTP type listener.
    400 ProtocalIllegal.Listener The specified listener protocol is invalid. The specified listener protocol is invalid.
    400 QuotaExceeded.EndPoint The maximum number of endpoints is exceeded. The maximum number of endpoints is exceeded.
    400 QuotaExceeded.ForwardingRule The number of forwarding rule exceeds the limit.
    400 QuotaExceeded.Listener The maximum number of listeners is exceeded. The maximum number of listeners is exceeded.
    400 QuotaExceeded.ListenerPort The maximum number of listener ports is exceeded. The maximum number of listener ports is exceeded.
    400 QuotaExceeded.PortOverride The number of port override exceeds the limit.
    400 QuotaExceeded.RuleConditionConfig The number of path and host exceeds the limit.
    400 RegionRepeat.IpSet Only one IpSet can be created in an accelerated region. Only one IpSet can be created in an accelerated region.
    400 Repeat.IpSets The configuration of IpSet is duplicated. The configuration of IpSet is duplicated.
    400 RepeatPathAndHost.ForwardingRule The path and host %s are duplicated.
    400 StateError.Accelerator The state of the accelerated instance is invalid.
    400 StateError.BandwidthPackage The state of bandwidth package is invalid. The state of bandwidth package is invalid.
    400 StateError.BandwidthPackageBind The state of binding for the bandwidth package is invalid. The state of binding for the bandwidth package is invalid.
    400 StateError.EndPointGroup The specified state of endpoint group is invalid. The specified state of endpoint group is invalid.
    400 StateError.ForwardingRule The forwarding rule state %s is illegal.
    400 StateError.IpSet The state of IpSet is invalid. The state of IpSet is invalid.
    400 TooManySpareIp.Accelerator Too many SpareIp accepted under the same Accelerator
    400 UpgradeError.BandwidthPackage The bandwidth package configurations should be either all upgrades or all downgrades. The bandwidth package configurations should be either all upgrades or all downgrades.

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

    変更履歴

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