
# 拒绝连接创建 - RejectAttachment
#### 功能介绍
拒绝连接创建
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-er/er_02_0008.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-er/er_02_0015.html)。
| 授权项                   | 访问级别  | 资源类型（\*为必须）    | 条件键                                                                                                                                                                                                                                                                                                                                                    | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| er:attachments:reject | Write | attachments \* | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | -  | -      |
   
#### URI
POST /v3/{project_id}/enterprise-router/{er_id}/attachments/{attachment_id}/reject
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述        |
|:---|:---|:---|:---|
| project_id    | 是    | String | 项目ID      |
| er_id         | 是    | String | 企业路由器实例ID |
| attachment_id | 是    | String | 连接ID      |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数         | 参数类型                                                                        | 描述       |
|:---|:---|:---|
| attachment | [AttachmentResponse] object | 连接基本信息详情 |
| request_id | String                                                                      | 请求id     |
   
 表3AttachmentResponse 
| 参数                  | 参数类型                                                    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| name                | String                                                  | 连接名字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| id                  | String                                                  | 连接ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| description         | String                                                  | 描述信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| state               | String                                                  | - 参数解释：连接状态   - 取值范围： - pending：等待中   - available：可用   - modifying：修改中   - deleting：删除中   - deleted：已删除   - failed：失败   - pending_acceptance：等待接受   - rejected：拒绝   - initiating_request：初始化请求   - freezed：冻结   - invalid：无效的      |
| created_at          | String                                                  | 创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| updated_at          | String                                                  | 更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| tags                | Array of [Tag] objects | 连接关联tag                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| project_id          | String                                                  | 项目ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| resource_id         | String                                                  | 内部连接关联的资源ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| resource_type       | String                                                  | 内部连接关联的资源类型: - vgw：云专线的虚拟网关   - vpn：VPN网关   - gdgw：全域接入网关   - peering：对等连接，通过云连接CC加载不同区域的企业路由器来创建"对等连接（Peering）"连接   - ecn：企业连接网   - vpc：虚拟私有云   - cfw：云防火墙                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| resource_project_id | String                                                  | 资源所属项目ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
 表4Tag 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| key   | String | 标签键，规则： - 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线"_"，点"."，冒号":"，等号"="，加号"+"，中划线"-"，"@"。   - _sys_开头属于系统标签，租户不能输入。   - 标签key不能为空（长度不能为0）。   - 长度在1-128之间。    最小长度：**1** 最大长度：**128** |
| value | String | 标签值，规则： - 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线"_"，点"."，冒号":"，等号"="，加号"+"，中划线"-"，"@"。   - 资源标签值可以为空（empty or null）。   - 长度在0-255之间。    最小长度：**0** 最大长度：**255**                                                                                                                                                  |
   
#### 请求示例
拒绝创建连接
```
POST https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/6f83b848-8331-4271-ac0c-ef94b7686402/attachments/6f83b848-8331-4271-ac0c-ef94b7686401/reject
```
#### 响应示例
**状态码：200**
OK
```
{
  "attachment" : {
    "id" : "6f83b848-8331-4271-ac0c-ef94b7686402",
    "name" : "vpc attachment",
    "description" : "VPC连接",
    "state" : "rejected",
    "created_at" : "2020-03-11T15:13:31.000Z",
    "updated_at" : "2020-03-11T15:13:31.000Z",
    "tags" : [ ],
    "project_id" : "0605767a9980d5762fbcc00b3537e757",
    "resource_id" : "b715e131-3371-4e17-a2de-4f669e24439a",
    "resource_type" : "vpc",
    "resource_project_id" : "0605767a9980d5762fbcc00b3537e751"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}
```
#### SDK代码示例
SDK代码示例如下。
- [Java]
  ```
  package com.huaweicloud.sdk.test;
  import com.huaweicloud.sdk.core.auth.ICredential;
  import com.huaweicloud.sdk.core.auth.BasicCredentials;
  import com.huaweicloud.sdk.core.exception.ConnectionException;
  import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
  import com.huaweicloud.sdk.core.exception.ServiceResponseException;
  import com.huaweicloud.sdk.er.v3.region.ErRegion;
  import com.huaweicloud.sdk.er.v3.*;
  import com.huaweicloud.sdk.er.v3.model.*;
  public class RejectAttachmentSolution {
      public static void main(String[] args) {
          // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
          // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
          String ak = System.getenv("CLOUD_SDK_AK");
          String sk = System.getenv("CLOUD_SDK_SK");
          String projectId = "{project_id}";
          ICredential auth = new BasicCredentials()
                  .withProjectId(projectId)
                  .withAk(ak)
                  .withSk(sk);
          ErClient client = ErClient.newBuilder()
                  .withCredential(auth)
                  .withRegion(ErRegion.valueOf("<YOUR REGION>"))
                  .build();
          RejectAttachmentRequest request = new RejectAttachmentRequest();
          request.withErId("{er_id}");
          request.withAttachmentId("{attachment_id}");
          try {
              RejectAttachmentResponse response = client.rejectAttachment(request);
              System.out.println(response.toString());
          } catch (ConnectionException e) {
              e.printStackTrace();
          } catch (RequestTimeoutException e) {
              e.printStackTrace();
          } catch (ServiceResponseException e) {
              e.printStackTrace();
              System.out.println(e.getHttpStatusCode());
              System.out.println(e.getRequestId());
              System.out.println(e.getErrorCode());
              System.out.println(e.getErrorMsg());
          }
      }
  }
  ```
- [Python]
  ```
  # coding: utf-8
  import os
  from huaweicloudsdkcore.auth.credentials import BasicCredentials
  from huaweicloudsdker.v3.region.er_region import ErRegion
  from huaweicloudsdkcore.exceptions import exceptions
  from huaweicloudsdker.v3 import *
  if __name__ == "__main__":
      # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak = os.environ["CLOUD_SDK_AK"]
      sk = os.environ["CLOUD_SDK_SK"]
      projectId = "{project_id}"
      credentials = BasicCredentials(ak, sk, projectId)
      client = ErClient.new_builder() \
          .with_credentials(credentials) \
          .with_region(ErRegion.value_of("<YOUR REGION>")) \
          .build()
      try:
          request = RejectAttachmentRequest()
          request.er_id = "{er_id}"
          request.attachment_id = "{attachment_id}"
          response = client.reject_attachment(request)
          print(response)
      except exceptions.ClientRequestException as e:
          print(e.status_code)
          print(e.request_id)
          print(e.error_code)
          print(e.error_msg)
  ```
- [Go]
  ```
  package main
  import (
  "fmt"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
      er "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/er/v3"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/er/v3/model"
      region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/er/v3/region"
  )
  func main() {
      // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak := os.Getenv("CLOUD_SDK_AK")
      sk := os.Getenv("CLOUD_SDK_SK")
      projectId := "{project_id}"
      auth, err := basic.NewCredentialsBuilder().
          WithAk(ak).
          WithSk(sk).
          WithProjectId(projectId).
          SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      hcClient, err := er.ErClientBuilder().
           WithRegion(region.ValueOf("<YOUR REGION>")).
           WithCredential(auth).
           SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      client := er.NewErClient(hcClient)
      request := &model.RejectAttachmentRequest{}
  request.ErId = "{er_id}"
  request.AttachmentId = "{attachment_id}"
  response, err := client.RejectAttachment(request)
  if err == nil {
          fmt.Printf("%+v\n", response)
      } else {
          fmt.Println(err)
      }
  }
  ```
- [更多]
  更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ER/sdk?api=RejectAttachment)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-er/ErrorCode.html)。
