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

Function Compute:UpdateService

最終更新日:Sep 11, 2024

この操作では、サービス情報を更新します。

デバッグ

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

リクエストヘッダー

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

リクエストの構造

PUT /services/{serviceName}

リクエストパラメーター

パラメーター

データ型

位置

必須

説明

If-Match

String

ヘッダー

なし

e19d5cd5af0378da05f63f891c7467af

サービスの名前です。

serviceName

String

パス

あり

service_name

サービスの名前です。

オブジェクト

本文

なし

サービスの定義。

説明

String

本文

なし

test_description

サービスの説明。

internetAccess

Boolean

本文

なし

true

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

  • true

  • false

logConfig

LogConfig

本文

なし

ログの設定。 関数実行ログを保存するLogstoreを指定します。

nasConfig

NASConfig

本文

なし

Apsara File Storage NAS (NAS) ファイルシステム設定。 指定されたサービスの関数がNASファイルシステムにアクセスできるようにします。

role

String

本文

なし

acs:ram::19861 **** 3743:role/fc-public-test

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

  • 関数によって生成されたログをLogstoreに送信します。

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

vpcConfig

VPCConfig

本文

なし

関数が指定されたVPCにアクセスできるようにするVPC設定。

tracingConfig

TracingConfig

本文

なし

Tracing Analysisの設定をします。 Function ComputeをTracing Analysisと統合した後、Function Computeでのリクエストの滞在時間の記録、関数のコールドスタート時間の表示、関数の実行時間の記録を行うことができます。 詳細については、「トレース分析」をご参照ください。

レスポンスパラメーター

パラメーター

データ型

説明

ETag

String

e19d5cd5af0378da05f63f891c7467af

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

createdTime

String

2020-04-03T05:57:28Z

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

説明

String

test_description

サービスの説明。

internetAccess

Boolean

true

関数がインターネットへのアクセスを許可されたかどうかを示します。 有効な値:

  • true

  • false

lastModifiedTime

String

2020-04-03T07:57:33Z

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

logConfig

LogConfig

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

nasConfig

NASConfig

Apsara File Storage NAS (NAS) ファイルシステム設定。 指定されたサービスの関数がNASファイルシステムにアクセスできるようにします。

role

String

acs:ram::19861 **** 3743:role/fc-public-test

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

  • 関数によって生成されたログをLogstoreに送信します。

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

serviceId

String

c910061f-f6fa-44e6-b659-56 ***

サービスごとにシステムによって生成されるID。Function Computeで一意です。

serviceName

String

service_name

サービスの名前です。

vpcConfig

VPCConfig

関数が指定されたVPCにアクセスできるようにするVPC設定。

tracingConfig

TracingConfig

Tracing Analysisの設定をします。 Function ComputeをTracing Analysisと統合した後、Function Computeでのリクエストの滞在時間の記録、関数のコールドスタート時間の表示、関数の実行時間の記録を行うことができます。 詳細については、「トレース分析」をご参照ください。

リクエストの例

PUT /2016-08-15/services/service_name HTTP/1.1
Common request headers
{
    "role":"acs:ram::19861****3743:role/fc-public-test",
    "logConfig":{
        "enableRequestMetrics":"true",
        "project":"test_project",
        "logstore":"test_logstore"
    },
    "tracingConfig":{
        "params":{
            "endpoint":"http://tracing-*********-dc-sh-internal.aliyuncs.com/*****_iioe7jcnuk@***************_iioe7*****@******d2afe****/api/traces"
        },
        "type":"Jaeger"
    },
    "vpcConfig":{
        "vpcId":"vpc_***",
        "vSwitchIds":[
            "vsw_***"
        ],
        "securityGroupId":"sg_bp18hj1wtxgy3***"
    },
    "nasConfig":{
        "userId":100,
        "groupId":100,
        "mountPoints":[
            {
                "serverAddr":"***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
                "mountDir":"/home/test"
            }
        ]
    }
}

正常に処理された場合のレスポンス例

JSON 形式

HTTP/1.1 200 OK
Common response headers
{
  "serviceName": "service_name",
  "description": "test_description",
  "role": "acs:ram::19861****3743:role/fc-public-test",
  "logConfig": {
    "enableRequestMetrics": "true",
    "project": "test_project",
    "logstore": "test_logstore"
  },
  "serviceId": "c910061f-f6fa-44e6-b659-56***",
  "createdTime": "2020-04-03T05:57:28Z",
  "lastModifiedTime": "2020-04-03T07:57:33Z",
  "tracingConfig": {
    "params": {
      "endpoint": "http://tracing-*********-dc-sh-internal.aliyuncs.com/*****_iioe7jcnuk@***************_iioe7*****@******d2afe****/api/traces"
    },
    "type": "Jaeger"
  },
  "vpcConfig": {
    "vpcId": "vpc_***",
    "vSwitchIds": [
      "vsw_***"
    ],
    "securityGroupId": "sg_bp18hj1wtxgy3***"
  },
  "internetAccess": true,
  "nasConfig": {
    "userId": 100,
    "groupId": 100,
    "mountPoints": [
      {
        "serverAddr": "***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
        "mountDir": "/home/test"
      }
    ]
  }
}

エラーコード

エラーコードの一覧は、「API エラーセンター」をご参照ください。