기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Neptune 서브넷 API
<a name="api-subnets"></a>

**작업**
+ [CreateDBSubnetGroup(작업)](#CreateDBSubnetGroup)
+ [DeleteDBSubnetGroup(작업)](#DeleteDBSubnetGroup)
+ [ModifyDBSubnetGroup(작업)](#ModifyDBSubnetGroup)
+ [DescribeDBSubnetGroups(작업)](#DescribeDBSubnetGroups)

**구조:**
+ [Subnet(구조)](#Subnet)
+ [DBSubnetGroup(구조)](#DBSubnetGroup)

## CreateDBSubnetGroup(작업)
<a name="CreateDBSubnetGroup"></a>

         이 API의 AWS 이름은 `create-db-subnet-group`입니다.

새 DB 서브넷 그룹을 생성합니다. DB 서브넷 그룹에는 Amazon 리전 내 둘 이상의 AZ에 적어도 하나 이상의 서브넷이 있어야 합니다.

**요청**
+ **DBSubnetGroupDescription**(CLI의 경우: `--db-subnet-group-description`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹에 대한 설명입니다.
+ **DBSubnetGroupName**(CLI의 경우: `--db-subnet-group-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 이름입니다. 이 값은 소문자 문자열로 저장됩니다.

  제약: 255자 이하의 문자, 숫자, 마침표, 밑줄, 공백 또는 하이픈만 포함해야 합니다. 기본값이 아니어야 합니다.

  예시: `mySubnetgroup`
+ **SubnetIds**(CLI의 경우: `--subnet-ids`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 EC2 서브넷 ID입니다.
+ **Tags**(CLI의 경우: `--tags`) - [태그](api-other-apis.md#Tag) 객체의 배열입니다.

  새 DB 서브넷 그룹에 할당할 태그입니다.

**응답**:

Amazon Neptune DB 서브넷 그룹에 대한 세부 정보가 포함되어 있습니다.

이 데이터 형식은 [DescribeDBSubnetGroups(작업)](#DescribeDBSubnetGroups) 작업에서 응답 요소로 사용됩니다.
+ **DBSubnetGroupArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 Amazon 리소스 이름(ARN)입니다.
+ **DBSubnetGroupDescription** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹에 대한 설명을 제공합니다.
+ **DBSubnetGroupName** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 이름입니다.
+ **SubnetGroupStatus** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 상태를 제공합니다.
+ **Subnets** – [서브넷](#Subnet) 객체의 배열입니다.

   [Subnet(구조)](#Subnet) 요소의 목록이 포함되어 있습니다.
+ **VpcId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 VpcId를 제공합니다.

**오류**
+ [DBSubnetGroupAlreadyExistsFault](api-faults.md#DBSubnetGroupAlreadyExistsFault)
+ [DBSubnetGroupQuotaExceededFault](api-faults.md#DBSubnetGroupQuotaExceededFault)
+ [DBSubnetQuotaExceededFault](api-faults.md#DBSubnetQuotaExceededFault)
+ [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)

## DeleteDBSubnetGroup(작업)
<a name="DeleteDBSubnetGroup"></a>

         이 API의 AWS CLI 이름은 `delete-db-subnet-group`입니다.

DB 서브넷 그룹을 삭제합니다.

**참고**  
지정된 데이터베이스 서브넷 그룹은 어떤 DB 인스턴스와도 연결되어 있으면 안 됩니다.

**요청**
+ **DBSubnetGroupName**(CLI의 경우: `--db-subnet-group-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  삭제할 데이터베이스 서브넷 그룹의 이름입니다.
**참고**  
기본 서브넷 그룹은 삭제할 수 없습니다.

  제약 조건:

  제약: 기존의 DBSubnetGroup 이름과 일치해야 합니다. 기본값이 아니어야 합니다.

  예시: `mySubnetgroup`

**응답**
+ *무응답 파라미터.*

**오류**
+ [InvalidDBSubnetGroupStateFault](api-faults.md#InvalidDBSubnetGroupStateFault)
+ [InvalidDBSubnetStateFault](api-faults.md#InvalidDBSubnetStateFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)

## ModifyDBSubnetGroup(작업)
<a name="ModifyDBSubnetGroup"></a>

         이 API의 AWS CLI 이름은 `modify-db-subnet-group`입니다.

기존 DB 서브넷 그룹을 수정합니다. DB 서브넷 그룹에는 Amazon 리전 내 둘 이상의 AZ에 적어도 하나 이상의 서브넷이 있어야 합니다.

**요청**
+ **DBSubnetGroupDescription**(CLI의 경우: `--db-subnet-group-description`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹에 대한 설명입니다.
+ **DBSubnetGroupName**(CLI의 경우: `--db-subnet-group-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 이름입니다. 이 값은 소문자 문자열로 저장됩니다. 기본 서브넷 그룹은 수정할 수 없습니다.

  제약: 기존의 DBSubnetGroup 이름과 일치해야 합니다. 기본값이 아니어야 합니다.

  예시: `mySubnetgroup`
+ **SubnetIds**(CLI의 경우: `--subnet-ids`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 EC2 서브넷 ID입니다.

**응답**:

Amazon Neptune DB 서브넷 그룹에 대한 세부 정보가 포함되어 있습니다.

이 데이터 형식은 [DescribeDBSubnetGroups(작업)](#DescribeDBSubnetGroups) 작업에서 응답 요소로 사용됩니다.
+ **DBSubnetGroupArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 Amazon 리소스 이름(ARN)입니다.
+ **DBSubnetGroupDescription** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹에 대한 설명을 제공합니다.
+ **DBSubnetGroupName** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 이름입니다.
+ **SubnetGroupStatus** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 상태를 제공합니다.
+ **Subnets** – [서브넷](#Subnet) 객체의 배열입니다.

   [Subnet(구조)](#Subnet) 요소의 목록이 포함되어 있습니다.
+ **VpcId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 VpcId를 제공합니다.

**오류**
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [DBSubnetQuotaExceededFault](api-faults.md#DBSubnetQuotaExceededFault)
+ [SubnetAlreadyInUse](api-faults.md#SubnetAlreadyInUse)
+ [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)

## DescribeDBSubnetGroups(작업)
<a name="DescribeDBSubnetGroups"></a>

         이 API의 AWS CLI 이름은 `describe-db-subnet-groups`입니다.

DBSubnetGroup 설명 목록을 반환합니다. DBSubnetGroupName이 지정된 경우, 이 목록에는 지정된 DBSubnetGroup에 대한 설명만 포함됩니다.

CIDR 범위에 대한 개요는 [Wikipedia 자습서](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)를 참조하십시오.

**요청**
+ **DBSubnetGroupName**(CLI의 경우: `--db-subnet-group-name`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  세부 정보를 반환할 DB 서브넷 그룹의 이름입니다.
+ **Filters**(CLI의 경우: `--filters`) - [필터](api-datatypes.md#Filter) 객체의 배열입니다.

  현재 지원되지 않는 파라미터입니다.
+ **Marker**(CLI의 경우: `--marker`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 DescribeDBSubnetGroups 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.
+ **MaxRecords**(CLI의 경우: `--max-records`) - IntegerOptional, 유형은 `integer`(32비트 부호 있는 정수)입니다.

   응답에 포함되는 최대 레코드 수입니다. 지정된 `MaxRecords` 값보다 레코드 수가 많으면 마커라고 부르는 페이지 매김 토큰을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다.

  기본값: 100

  제약: 최소 20, 최대 100입니다.

**응답**:
+ **DBSubnetGroups** – [DBSubnetGroup](#DBSubnetGroup) 객체의 배열입니다.

   [DBSubnetGroup(구조)](#DBSubnetGroup) 인스턴스의 목록입니다.
+ **Marker** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.

**오류**
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)

## *구조:*
<a name="api-subnets-structures-spacer"></a>

## Subnet(구조)
<a name="Subnet"></a>

서브넷을 지정합니다.

 이 데이터 형식은 [DescribeDBSubnetGroups(작업)](#DescribeDBSubnetGroups) 작업에서 응답 요소로 사용됩니다.

**Fields**
+ **SubnetAvailabilityZone** - [AvailabilityZone](api-datatypes.md#AvailabilityZone) 객체입니다.

  서브넷이 들어 있는 EC2 가용 영역을 지정합니다.
+ **SubnetIdentifier** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  서브넷의 식별자를 지정합니다.
+ **SubnetStatus** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  서브넷의 상태를 지정합니다.

## DBSubnetGroup(구조)
<a name="DBSubnetGroup"></a>

Amazon Neptune DB 서브넷 그룹에 대한 세부 정보가 포함되어 있습니다.

이 데이터 형식은 [DescribeDBSubnetGroups(작업)](#DescribeDBSubnetGroups) 작업에서 응답 요소로 사용됩니다.

**Fields**
+ **DBSubnetGroupArn** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 Amazon 리소스 이름(ARN)입니다.
+ **DBSubnetGroupDescription** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹에 대한 설명을 제공합니다.
+ **DBSubnetGroupName** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 이름입니다.
+ **SubnetGroupStatus** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 상태를 제공합니다.
+ **Subnets** - [서브넷](#Subnet) 객체 배열입니다.

   [Subnet(구조)](#Subnet) 요소의 목록이 포함되어 있습니다.
+ **VpcId** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  DB 서브넷 그룹의 VpcId를 제공합니다.

`DBSubnetGroup`는 다음의 응답 요소로 사용됩니다.
+ [CreateDBSubnetGroup](#CreateDBSubnetGroup)
+ [ModifyDBSubnetGroup](#ModifyDBSubnetGroup)