すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Service Mesh:CreateServiceMesh

    ドキュメントセンター

    Alibaba Cloud Service Mesh:CreateServiceMesh

    最終更新日:Aug 25, 2025

    Service Mesh インスタンスを作成します。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    servicemesh:CreateServiceMesh

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Service Mesh インスタンスが存在するリージョンの ID。

    cn-hangzhou
    IstioVersion

    string

    任意

    Istio のバージョン。

    v1.5.4.1-g5960ec40-aliyun
    VpcId

    string

    必須

    仮想プライベートクラウド (VPC) ID。

    vpc-xzelac2tw4ic7wz31****
    ApiServerPublicEip

    boolean

    任意

    API サーバーをインターネットに公開するかどうかを指定します。有効な値：

    • true: API サーバーをインターネットに公開します。

    • false: API サーバーをインターネットに公開しません。

    デフォルト値: false。

    説明

    このパラメーターが false に設定されている場合、インターネットからクラスターの API サーバーにアクセスすることはできません。

    false
    Tracing

    boolean

    任意

    トレース分析を有効にするかどうかを指定します。有効な値：

    • true: トレース分析を有効にします。

    • false: トレース分析を無効にします。

    デフォルト値: false。

    false
    Name

    string

    任意

    Service Mesh インスタンスの名前。

    mesh1
    VSwitches

    string

    必須

    仮想スイッチ ID。

    ["vsw-xzegf5dndkbf4m6eg****"]
    TraceSampling

    number

    任意

    トレースサンプリングの割合。

    100
    CustomizedZipkin

    boolean

    任意

    セルフマネージド Zipkin システムを使用するかどうかを指定します。有効な値：

    • true: セルフマネージド Zipkin システムを使用します。

    • false: Alibaba Cloud トレース分析を使用します。

    デフォルト値: false。

    false
    LocalityLoadBalancing

    boolean

    任意

    地域負荷分散を有効にするかどうかを指定します。有効な値：

    • true: 地域負荷分散を有効にします。

    • false: 地域負荷分散を無効にします。

    デフォルト値: false。

    false
    LocalityLBConf

    string

    任意

    地域負荷分散の構成。

    {"failover":[{"from":"cn-hangzhou","to":"cn-shanghai"}]}
    Telemetry

    boolean

    任意

    Prometheus モニタリングを有効にするかどうかを指定します。Managed Service for Prometheus を使用することをお勧めします。有効な値：

    • true: Prometheus モニタリングを有効にします。

    • false: Prometheus モニタリングを無効にします。

    デフォルト値: false。

    false
    OpenAgentPolicy

    boolean

    任意

    Open Policy Agent (OPA) プラグインと統合するかどうかを指定します。有効な値：

    • true: OPA プラグインと統合します。

    • false: OPA プラグインと統合しません。

    デフォルト値: false。

    false
    OPALogLevel

    string

    任意

    OPA プロキシコンテナのログレベル。

    info
    OPARequestCPU

    string

    任意

    OPA プロキシコンテナの CPU リソースリクエスト。標準の Kubernetes CPU フォーマットを使用できます。たとえば、1 は 1 つの vCPU を示します。

    1
    OPARequestMemory

    string

    任意

    OPA プロキシコンテナのメモリリソースリクエスト。標準の Kubernetes メモリフォーマットを使用できます。たとえば、1 Mi は 1024 KB を示します。

    512Mi
    OPALimitCPU

    string

    任意

    OPA プロキシコンテナの CPU リソース制限。

    2
    OPALimitMemory

    string

    任意

    OPA プロキシコンテナのメモリリソース制限。標準の Kubernetes メモリフォーマットを使用できます。たとえば、1 Mi は 1024 KB を示します。

    1024Mi
    EnableAudit

    boolean

    任意

    メッシュ監査を有効にするかどうかを指定します。この機能を有効にするには、最初に Simple Log Service をアクティブにする必要があります。有効な値：

    • true: メッシュ監査を有効にします。

    • false: メッシュ監査を無効にします。

    デフォルト値: false。

    false
    AuditProject

    string

    任意

    メッシュ監査に使用される Simple Log Service プロジェクトの名前。

    デフォルト値: mesh-log-{meshId}。

    mesh-log-xxxx
    ClusterDomain

    string

    任意

    クラスタードメイン。

    cluster.local
    ProxyRequestCPU

    string

    任意

    プロキシコンテナの CPU リソースリクエスト。

    100m
    ProxyRequestMemory

    string

    任意

    プロキシコンテナのメモリリソースリクエスト。

    128Mi
    ProxyLimitCPU

    string

    任意

    プロキシコンテナの CPU リソース制限。

    2000m
    ProxyLimitMemory

    string

    任意

    プロキシコンテナのメモリリソース制限。

    1024Mi
    IncludeIPRanges

    string

    任意

    プロキシへのアクセスが許可されている IP アドレス範囲。

    *
    ExcludeIPRanges

    string

    任意

    プロキシへのアクセスが許可されていない IP アドレス範囲。

    100.100.10*.***
    ExcludeOutboundPorts

    string

    任意

    除外するアウトバウンドポートのカンマ区切りリスト。

    80,81
    ExcludeInboundPorts

    string

    任意

    除外するインバウンドポートのカンマ区切りリスト。

    80,81
    OpaEnabled

    boolean

    任意

    OPA を有効にするかどうかを指定します。有効な値：

    • true: OPA を有効にします。

    • false: OPA を無効にします。

    デフォルト値: false。

    false
    KialiEnabled

    boolean

    任意

    メッシュトポロジー機能を有効にするかどうかを指定します。この機能を有効にするには、最初に Prometheus モニタリングを有効にする必要があります。Prometheus モニタリングが無効になっている場合、この機能は強制的に無効になります。有効な値：

    • true: メッシュトポロジー機能を有効にします。

    • false: メッシュトポロジー機能を無効にします。

    デフォルト値: false。

    false
    AccessLogEnabled

    boolean

    任意

    アクセスログを有効にするかどうかを指定します。有効な値：

    • true: アクセスログを有効にします。

    • false: アクセスログを無効にします。

    デフォルト値: false。

    false
    CustomizedPrometheus

    boolean

    任意

    セルフマネージド Prometheus システムを使用するかどうかを指定します。有効な値：

    • true: セルフマネージド Prometheus システムを使用します。

    • false: セルフマネージド Prometheus システムを使用しません。

    デフォルト値: false。

    false
    PrometheusUrl

    string

    任意

    セルフマネージド Prometheus システムのエンドポイント。

    http://prometheus:9090
    RedisFilterEnabled

    boolean

    任意

    Redis フィルターを有効にするかどうかを指定します。有効な値：

    • true: Redis フィルターを有効にします。

    • false: Redis フィルターを無効にします。

    デフォルト値: false。

    true
    MysqlFilterEnabled

    boolean

    任意

    MySQL フィルターを有効にするかどうかを指定します。有効な値：

    • true: MySQL フィルターを有効にします。

    • false: MySQL フィルターを無効にします。

    デフォルト値: false。

    false
    ThriftFilterEnabled

    boolean

    任意

    Thrift フィルターを有効にするかどうかを指定します。有効な値：

    • true: Thrift フィルターを有効にします。

    • false: Thrift フィルターを無効にします。

    デフォルト値: false。

    false
    WebAssemblyFilterEnabled

    boolean

    任意

    WebAssembly フィルターを有効にするかどうかを指定します。有効な値：

    • true: WebAssembly フィルターを有効にします。

    • false: WebAssembly フィルターを無効にします。

    デフォルト値: false。

    false
    MSEEnabled

    boolean

    任意

    Microservices Engine (MSE) を有効にするかどうかを指定します。有効な値：

    • true: MSE を有効にします。

    • false: MSE を無効にします。

    デフォルト値: false。

    false
    DNSProxyingEnabled

    boolean

    任意

    DNS プロキシを有効にするかどうかを指定します。有効な値：

    • true: DNS プロキシを有効にします。

    • false: DNS プロキシを無効にします。

    デフォルト値: false。

    false
    Edition

    string

    任意

    ASM インスタンスのエディション。

    Pro
    ConfigSourceEnabled

    boolean

    任意

    外部サービスレジストリを有効にするかどうかを指定します。有効な値：

    • true: 外部サービスレジストリを有効にします。

    • false: 外部サービスレジストリを無効にします。

    デフォルト値: false。

    false
    ConfigSourceNacosID

    string

    任意

    Nacos インスタンスの ID。

    mse-cn-tl326******
    DubboFilterEnabled

    boolean

    任意

    Dubbo フィルターを有効にするかどうかを指定します。有効な値：

    • true: Dubbo フィルターを有効にします。

    • false: Dubbo フィルターを無効にします。

    デフォルト値: false。

    false
    FilterGatewayClusterConfig

    boolean

    任意

    ゲートウェイ構成のフィルタリングを有効にするかどうかを指定します。有効な値：

    • true: ゲートウェイ構成のフィルタリングを有効にします。

    • false: ゲートウェイ構成のフィルタリングを無効にします。

    デフォルト値: false。

    false
    EnableSDSServer

    boolean

    任意

    Secret Discovery Service (SDS) を有効にするかどうかを指定します。有効な値：

    • true: SDS を有効にします。

    • false: SDS を無効にします。

    デフォルト値: false。

    false
    AccessLogServiceEnabled

    boolean

    任意

    Envoy の gRPC Access Log Service (ALS) を有効にするかどうかを指定します。有効な値：

    • true: Envoy の gRPC ALS を有効にします。

    • false: Envoy の gRPC ALS を無効にします。

    デフォルト値: false。

    false
    AccessLogServiceHost

    string

    任意

    Envoy の gRPC ALS のエンドポイント。

    0.0.0.0
    AccessLogServicePort

    integer

    任意

    Envoy の gRPC ALS のポート。

    9999
    GatewayAPIEnabled

    boolean

    任意

    Gateway API を有効にするかどうかを指定します。有効な値：

    • true: Gateway API を有効にします。

    • false: Gateway API を無効にします。

    デフォルト値: false。

    false
    ControlPlaneLogEnabled

    boolean

    任意

    コントロールプレーンログ収集を有効にするかどうかを指定します。有効な値：

    • true: コントロールプレーンログ収集を有効にします。

    • false: コントロールプレーンログ収集を無効にします。

    デフォルト値: false。

    false
    ControlPlaneLogProject

    string

    任意

    コントロールプレーンログ収集用の Simple Log Service プロジェクト。

    mesh-log-cf245a429b6ff4b6e97f20797758*****
    AccessLogFormat

    string

    任意

    アクセスログのカスタムフォーマット。このパラメーターは、アクセスログを有効にした場合にのみ使用できます。値は、authority_for、bytes_received、bytes_sent、downstream_local_address、downstream_remote_address、duration、istio_policy_status、method、path、protocol、requested_server_name、response_code、response_flags、route_name、start_time、trace_id、upstream_cluster、upstream_host、upstream_local_address、upstream_service_time、upstream_transport_failure_reason、user_agent、x_forwarded_for というキーを含む JSON 文字列である必要があります。

    {"authority_for":"%REQ(:AUTHORITY)%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","downstream_local_address":"%DOWNSTREAM_LOCAL_ADDRESS%","downstream_remote_address":"%DOWNSTREAM_REMOTE_ADDRESS%","duration":"%DURATION%","istio_policy_status":"%DYNAMIC_METADATA(istio.mixer:status)%","method":"%REQ(:METHOD)%","path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","protocol":"%PROTOCOL%","request_id":"%REQ(X-REQUEST-ID)%","requested_server_name":"%REQUESTED_SERVER_NAME%","response_code":"%RESPONSE_CODE%","response_flags":"%RESPONSE_FLAGS%","route_name":"%ROUTE_NAME%","start_time":"%START_TIME%","trace_id":"%REQ(X-B3-TRACEID)%","upstream_cluster":"%UPSTREAM_CLUSTER%","upstream_host":"%UPSTREAM_HOST%","upstream_local_address":"%UPSTREAM_LOCAL_ADDRESS%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_transport_failure_reason":"%UPSTREAM_TRANSPORT_FAILURE_REASON%","user_agent":"%REQ(USER-AGENT)%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%"}
    AccessLogFile

    string

    任意

    アクセスログを有効または無効にするかどうかを指定します。有効な値：

    • """: アクセスログを無効にします。

    • /dev/stdout: アクセスログを有効にします。

    /dev/stdout
    AccessLogProject

    string

    任意

    アクセスログ収集用の Simple Log Service プロジェクト。

    mesh-log-cf245a429b6ff4b6e97f20797758*****
    EnableCRHistory

    boolean

    任意

    ASM の Istio リソースの履歴バージョン管理機能を有効にするかどうかを指定します。有効な値：

    • true: 履歴バージョン管理機能を有効にします。

    • false: 履歴バージョン管理機能を無効にします。

    デフォルト値: false。

    false
    CRAggregationEnabled

    boolean

    任意

    データプレーンクラスターが Kubernetes API を使用して Istio リソースにアクセスできるようにするかどうかを指定します。この機能は、v1.9.7.93 以降の ASM インスタンスでのみ使用できます。有効な値：

    • true: データプレーンクラスターが Istio リソースにアクセスできるようにします。

    • false: データプレーンクラスターが Istio リソースにアクセスできないようにします。

    デフォルト値: false。

    false
    ApiServerLoadBalancerSpec

    string

    任意

    API サーバーにバインドされている Server Load Balancer (SLB) インスタンスの仕様。有効な値: slb.s1.small、slb.s2.small、slb.s2.medium、slb.s3.small、slb.s3.medium、slb.s3.large。

    slb.s1.small
    PilotLoadBalancerSpec

    string

    任意

    コントロールプレーンの Istio Pilot にバインドされている SLB インスタンスの仕様。有効な値: slb.s1.small、slb.s2.small、slb.s2.medium、slb.s3.small、slb.s3.medium、slb.s3.large。

    slb.s1.small
    ChargeType

    string

    任意

    SLB インスタンスの課金方法。有効な値：

    • PayOnDemand: 従量課金制。

    • PrePay: サブスクリプション。

    PrePay
    Period

    integer

    任意

    このパラメーターは、ChargeType を PrePay に設定した場合にのみ有効です。SLB インスタンスのサブスクリプション期間。単位: 月。インスタンスを 1 年間購入する場合は、12 と入力します。

    3
    AutoRenew

    boolean

    任意

    サブスクリプション SLB インスタンスの自動更新を有効にするかどうかを指定します。有効な値：

    • true: 自動更新を有効にします。

    • false: 自動更新を無効にします。

    true
    AutoRenewPeriod

    integer

    任意

    このパラメーターは、ChargeType を PrePay に設定した場合にのみ有効です。自動更新期間。サブスクリプション期間が 1 年未満の場合、このパラメーターの値はインスタンスを更新する月数を示します。サブスクリプション期間が 1 年を超える場合、このパラメーターの値はインスタンスを更新する年数を示します。

    3
    ClusterSpec

    string

    任意

    Service Mesh インスタンスの仕様。有効な値：

    • standard: Standard Edition。

    • enterprise: Enterprise Edition。

    • ultimate: Ultimate Edition。

    standard
    MultiBufferEnabled

    boolean

    任意

    MultiBuffer に基づく TLS パフォーマンス最適化を有効にするかどうかを指定します。有効な値：

    • true: 機能を有効にします。

    • false: 機能を無効にします。

    デフォルト値: true。

    true
    MultiBufferPollDelay

    string

    任意

    MultiBuffer 有効化ステータスの同期期間。デフォルト値: 30s。

    30s
    UseExistingCA

    boolean

    任意

    既存の認証局 (CA) 証明書と秘密鍵を使用するかどうかを指定します。

    false
    ExistingCaCert

    string

    任意

    Base64 エンコード形式の CA 証明書。このパラメーターは、通常、セルフマネージド Istio クラスターを ASM に移行するために使用されます。値は、セルフマネージド Istio クラスターの istio-system 名前空間にある istio-ca-secret シークレットの ca-cert.pem ファイルの内容に対応します。

    CA cert content, base64 encoded format.
    ExistingCaKey

    string

    任意

    Base64 エンコード形式の CA 秘密鍵。このパラメーターは、通常、セルフマネージド Istio クラスターを ASM に移行するために使用されます。値は、セルフマネージド Istio クラスターの istio-system 名前空間にある istio-ca-secret シークレットの ca-key.pem ファイルの内容に対応します。

    CA key content, base64 encoded format.
    ExistingCaType deprecated

    string

    任意

    既存の証明書のタイプ：

    • 1: Istiod の自己署名証明書。これは、istio-system 名前空間の istio-ca-secret シークレットに対応します。このタイプを使用する場合は、ExistingCaCert パラメーターと ExsitingCaKey パラメーターも指定する必要があります。

    • 2: Istiod の外部証明書。詳細については、プラグイン CA 証明書 を参照してください。これは、一般的に istio-system 名前空間の cacerts シークレットに対応します。このタイプを使用する場合は、ExisingRootCaCert パラメーターと ExisingRootCaKey パラメーターも指定する必要があります。

    1
    ExistingRootCaCert

    string

    任意

    既存のルート証明書。

    Existing CA cert content, base64 encoded format.
    ExistingRootCaKey deprecated

    string

    任意

    既存のルート証明書に対応する秘密鍵。

    Existing CA key content, base64 encoded format.
    CertChain

    string

    任意

    CA 証明書からルート証明書までの証明書チェーン。チェーンには少なくとも 2 つの証明書が含まれている必要があります。

    Base64 encoded PEM certificate chain.
    GuestCluster

    string

    任意

    Service Mesh インスタンスを作成するときに、インスタンスにクラスターを追加できます。このパラメーターを指定しない場合、クラスターは追加されません。クラスターは、Service Mesh インスタンスと同じ VPC と vSwitch に存在し、同じドメイン名を持っている必要があります。

    ACK cluster id
    Tag

    array<object>

    任意

    Service Mesh インスタンスに追加するタグ。次の情報が含まれます。

    • key: タグキー。

    • value: タグ値。

    object

    任意

    タグのリスト。

    Key

    string

    任意

    タグキー。

    env
    Value

    string

    任意

    タグ値。

    prod
    EnableAmbient

    boolean

    任意

    Service Mesh インスタンスの Ambient Mesh モードを有効にするかどうかを指定します。

    false
    PlaygroundScene

    string

    任意

    プレイグラウンドシナリオ。このパラメーターを指定すると、ASM プレイグラウンドインスタンスが作成されます。有効な値：

    • ewmaLb: 指数加重移動平均 (EWMA) 負荷分散シナリオ

    ewmaLb
    EnableACMG

    boolean

    任意

    ACMG モードを有効にするかどうかを指定します。

    false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    BD65C0AD-D3C6-48D3-8D93-38D2015C****
    ServiceMeshId

    string

    Service Mesh インスタンス ID。

    c08ba3fd1e6484b0f8cc1ad8fe10d****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "BD65C0AD-D3C6-48D3-8D93-38D2015C****",
  "ServiceMeshId": "c08ba3fd1e6484b0f8cc1ad8fe10d****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    404 ERR404 Not found

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

    変更履歴

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