すべてのプロダクト
Search
ドキュメントセンター

Function Compute:CreateService

最終更新日:Sep 11, 2024

サービスを作成します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 利便性を考慮して、この操作は OpenAPI Explorer で呼び出すことが推奨されます。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみが使用されます。 詳細は、共通パラメータを参照してください。

リクエスト構文

POST /services HTTP/1.1

リクエストパラメーター

パラメーター

データ型

位置

必須

説明

オブジェクト

本文

なし

サービスの定義。

説明

String

本文

なし

test_description

サービスの説明。

internetAccess

Boolean

本文

なし

true

関数がインターネットにアクセスできるようにするかどうかを指定します。 有効な値:

  • true: 関数がインターネットにアクセスできるようにします。 デフォルト値です。

  • false: 関数がインターネットにアクセスすることを許可しません。

logConfig

LogConfig

本文

なし

ログの設定。 Function Computeは、関数実行ログを指定されたLogstoreに書き込みます。

nasConfig

NASConfig

本文

なし

Apsara File Storage NAS (NAS) ファイルシステムの設定。 設定により、関数は指定されたNASリソースにアクセスできます。

role

String

本文

なし

acs:ram::198613743 ****:role/fc-public-test

Function Computeに必要な権限を付与するために使用されるRAMロール。 RAMロールは、次のシナリオで使用されます。

  • 関数実行ログをLogstoreに送信します。

  • 関数の実行中に他のクラウドリソースにアクセスするためのトークンを生成します。

serviceName

String

本文

あり

service_name

サービスの名前です。 サービス名には、英数字、アンダースコア (_) 、およびハイフン (-) のみを使用できます。 数字またはハイフン (-) で始めることはできません。長さは1 ~ 128文字である必要があります。

vpcConfig

VPCConfig

本文

なし

仮想プライベートクラウド (VPC) 設定。Function Computeの指定されたサービスの関数が指定されたVPCにアクセスできるようにします。

tracingConfig

TracingConfig

本文

なし

OpenTelemetryのマネージドサービスの設定。 Function ComputeのサービスにManaged Service for OpenTelemetryを設定した後、要求された関数の実行に必要な時間を記録し、関数のコールドスタート時間を表示し、関数の実行に必要な時間を記録できます。 詳細については、「概要」をご参照ください。

レスポンスパラメーター

パラメーター

データ型

説明

ETag

String

e19d5cd5af0378da05f63f891c7467af

サービス名のETag値。 この値は、変更されたサービスが変更されるサービスと一致することを保証するために使用される。

createdTime

String

2020-04-03T05:57:28Z

サービスが作成された時刻。

説明

String

test_description

サービスの説明。

internetAccess

Boolean

true

関数がインターネットにアクセスできるようにするかどうかを指定します。 有効な値:

  • true: 指定されたサービスの関数がインターネットにアクセスできるようにします。

  • false: 関数がインターネットにアクセスすることを許可しません。

lastModifiedTime

String

2020-04-03T05:57:28Z

サービスが最後に更新された時刻。

logConfig

LogConfig

ログ設定。 Function Computeは、関数実行ログを指定されたLogstoreに書き込みます。

nasConfig

NASConfig

NASファイルシステムの設定。 設定により、関数は指定されたNASリソースにアクセスできます。

role

String

acs:ram::198613743 ****:role/fc-public-test

Function Computeに必要な権限を付与するために使用されるRAMロール。 RAMロールは、次のシナリオで使用されます。

  • 関数実行ログをLogstoreに送信します。

  • 関数の実行中に他のクラウドリソースにアクセスするためのトークンを生成します。

serviceId

String

c910061f-****-44e6-b659-*** c

サービス用にシステムによって生成された一意のID。

serviceName

String

service_name

サービスの名前です。

vpcConfig

VPCConfig

VPC設定。 設定により、関数は指定されたVPCにアクセスできます。

tracingConfig

TracingConfig

OpenTelemetryのマネージドサービスの設定。 Function ComputeのサービスにManaged Service for OpenTelemetryを設定した後、要求された関数の実行に必要な時間を記録し、関数のコールドスタート時間を表示し、関数の実行に必要な時間を記録できます。 詳細については、「概要」をご参照ください。

リクエストの例

POST /2016-08-15/services HTTP/1.1
Common request headers
{
  "description" : "test_description",
  "internetAccess" : true,
  "logConfig" : {
    "logstore" : "test-prj",
    "project" : "test-logstore",
    "enableRequestMetrics" : true,
    "logBeginRule" : "DefaultRegex"
  },
  "nasConfig" : {
    "groupId" : "100",
    "mountPoints" : [ {
      "mountDir" : "/home/test",
      "serverAddr" : "***-uni85.cn-hangzhou.nas.aliyuncs.com:/"
    } ],
    "userId" : "100"
  },
  "role" : "acs:ram::198613743****:role/fc-public-test",
  "serviceName" : "service_name",
  "vpcConfig" : {
    "securityGroupId" : "sg-bp18hj1wtxgy3b0***",
    "vSwitchIds" : [ "vsw-bp1ozpcrdc6r****" ],
    "vpcId" : "vpc-***"
  },
  "tracingConfig" : {
    "type" : "Jaeger"
  }
}

通常のレスポンス例

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "createdTime" : "2020-04-03T05:57:28Z",
  "description" : "test_description",
  "internetAccess" : true,
  "lastModifiedTime" : "2020-04-03T05:57:28Z",
  "logConfig" : {
    "logstore" : "test-prj",
    "project" : "test-logstore",
    "enableRequestMetrics" : true,
    "logBeginRule" : "DefaultRegex"
  },
  "nasConfig" : {
    "groupId" : "100",
    "mountPoints" : [ {
      "mountDir" : "/home/test",
      "serverAddr" : "***-uni85.cn-hangzhou.nas.aliyuncs.com:/"
    } ],
    "userId" : "100"
  },
  "role" : "acs:ram::198613743****:role/fc-public-test",
  "serviceId" : "c910061f-****-44e6-b659-***c",
  "serviceName" : "service_name",
  "vpcConfig" : {
    "securityGroupId" : "sg-bp18hj1wtxgy3b0***",
    "vSwitchIds" : [ "vsw-bp1ozpcrdc6r****" ],
    "vpcId" : "vpc-***"
  },
  "tracingConfig" : {
    "type" : "Jaeger"
  }
}

エラーコード

エラーコードの一覧については、「サービスエラーコード」をご参照ください。