调用UpdateApplication修改应用的配置信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateApplication

要执行的操作。取值:UpdateApplication。

AppId String 472457090344041****

应用ID。

NewDisplayName String NewApp

新的显示名称。

NewRedirectUris String https://www.example.com

新的回调地址。

输入多个时,以英文分号(;)分隔。

NewPredefinedScopes String openid

新的应用权限范围。

关于应用权限范围的取值和描述,请参见OAuth范围。您也可以调用ListPredefinedScopes获取不同应用类型支持的应用权限范围。

输入多个应用权限范围时,以英文分号(;)分隔。

新的应用权限范围会覆盖原来的应用权限范围。例如:如果原来的应用权限范围是/acs/ccc,新设置的应用权限范围为/acs/alidns,则最终生效的应用权限范围为/acs/alidns。如果您想在原有范围基础上新增/acs/alidns,请将新的应用权限范围设置为/acs/ccc;/acs/alidns

NewSecretRequired Boolean true

是否需要应用密钥。取值:

  • true
  • false
说明
  • 对于WebApp和ServerApp类型的应用,该值会被强制设置为true,不支持修改。
  • 对于NativeApp类型的应用,可以设置为true或false,如不设置,默认为false。由于此类应用往往运行在非可信环境,无法有效保护应用密钥,因此建议您如无明确需要,不要设置为true。更多信息,请参见Native应用登录阿里云
NewAccessTokenValidity Integer 3600

新的访问令牌有效期。

取值范围:900~10800。单位:秒。

NewRefreshTokenValidity Integer 7776000

新的刷新令牌有效期。

取值范围:7200~31536000。单位:秒。

NewIsMultiTenant Boolean true

是否允许被其他账号安装。取值:

  • true
  • false

返回数据

名称 类型 示例值 描述
Application Struct

应用信息。

AccessTokenValidity Integer 3600

访问令牌有效期。单位:秒。

AccountId String 177242285274****

应用所属的阿里云账号ID。

AppId String 472457090344041****

应用ID。

AppName String myapp

应用名称。

AppType String WebApp

应用类型。

CreateDate String 2020-10-23T08:06:57Z

创建时间。

DelegatedScope Struct

应用权限范围信息。

PredefinedScopes Array of PredefinedScope

应用权限范围信息。

PredefinedScope
Description String 用于获取用户的OpenID(默认权限范围,不可移除)

范围描述。

Name String openid

范围名称。

DisplayName String NewApp

应用的显示名称。

IsMultiTenant Boolean true

是否允许被其他账号安装。

RedirectUris List https://www.example.com

回调地址。

RefreshTokenValidity Integer 7776000

刷新令牌有效期。单位:秒。

SecretRequired Boolean true

是否需要应用密钥。

UpdateDate String 2020-10-23T08:06:57Z

更新时间。

RequestId String 6616F09B-2768-4C11-8866-A8EE4C4A583E

请求ID。

示例

请求示例

https://[Endpoint]/?Action=UpdateApplication
&AppId=472457090344041****
&NewDisplayName=NewApp
&<公共请求参数>

正常返回示例

XML 格式

<UpdateApplicationResponse>
	  <RequestId>A4AE08F4-36FB-4274-BE4A-6BCAF7F15E85</RequestId>
	  <Application>
		    <AccountId>177242285274****</AccountId>
		    <SecretRequired>true</SecretRequired>
		    <IsMultiTenant>true</IsMultiTenant>
		    <CreateDate>2020-10-23T08:06:57Z</CreateDate>
		    <AppName>myapp</AppName>
		    <UpdateDate>2020-11-02T07:02:06Z</UpdateDate>
		    <DelegatedScope>
			      <PredefinedScopes>
				        <PredefinedScope>
					          <Description>用于获取用户的OpenID(默认权限范围,不可移除)</Description>
					          <Name>openid</Name>
				        </PredefinedScope>
			      </PredefinedScopes>
		    </DelegatedScope>
		    <AppId>472457090344041****</AppId>
		    <DisplayName>NewApp</DisplayName>
		    <AccessTokenValidity>3600</AccessTokenValidity>
		    <RedirectUris>
			      <RedirectUri>https://www.example.com</RedirectUri>
		    </RedirectUris>
		    <RefreshTokenValidity>7776000</RefreshTokenValidity>
		    <AppType>WebApp</AppType>
	  </Application>
</UpdateApplicationResponse>

JSON 格式

{
  "RequestId": "A4AE08F4-36FB-4274-BE4A-6BCAF7F15E85",
  "Application": {
    "AccountId": "177242285274****",
    "SecretRequired": true,
    "IsMultiTenant": true,
    "CreateDate": "2020-10-23T08:06:57Z",
    "AppName": "myapp",
    "UpdateDate": "2020-11-02T07:02:06Z",
    "DelegatedScope": {
      "PredefinedScopes": {
        "PredefinedScope": [
          {
            "Description": "用于获取用户的OpenID(默认权限范围,不可移除)",
            "Name": "openid"
          }
        ]
      }
    },
    "AppId": "472457090344041****",
    "DisplayName": "NewApp",
    "AccessTokenValidity": 3600,
    "RedirectUris": {
      "RedirectUri": [
        "https://www.example.com"
      ]
    },
    "RefreshTokenValidity": 7776000,
    "AppType": "WebApp"
  }
}

错误码

访问错误中心查看更多错误码。