v2

Network v2

Gophercloud v2.15.0의 network/v2 API를 하나의 인증된 서비스 객체에서 사용합니다. 인증, region, endpoint interface와 TLS 설정은 Connection이 관리합니다.

전체 API 호출 지원과 openstacksdk의 리소스 객체·복합 작업 지원은 별도로 추적합니다. Python 입력 별칭을 자동으로 Go 필드에 적용하지 않습니다. 기본 응답 모델은 Gophercloud 타입을 사용하며 SDK가 추가한 모델은 서비스별로 설명합니다. 수정한 응답이 자동 저장되지는 않습니다.

Networks/Subnets/Ports/Routers/SecurityGroups/SubnetPools/Trunks/QoSPolicies/SecurityAddressGroups.FindIdentity(ctx, identity, options...)는 이름·ID 문자열을 SDK가 자동 조회합니다. 기본 GET400·403·404 뒤 목록 fallback과 정확한 ID/이름·중복 검사, nil, nil 미존재 기본값을 제공하며 resource.WithIdentityFindIgnoreMissing(false)로 strict를 선택합니다. WithIdentityFindQuery의 caller 필터는 GET과 fallback 목록 모두에 보존하고 자동 이름 hint는 목록에만 추가합니다. query와 fallback은 공통 concrete 옵션으로 제어합니다. Python/Go 자동 조회 비교에 이 binding의 사용법·고정 부모·domain 필터·경로 정책을 설명합니다.

Neutron 9개 Update API의 UpdateOpts.RevisionNumber는 If-Match: revision_number=N 조건을 전송합니다. nil은 조건을 생략하고 포인터 0은 명시적 revision 0입니다. WithUpdateOptions의 최종 값에도 적용하며 412 오류에서 조건 없이 자동 재시도하지 않습니다. 조건부 Update와 Python 비교에 리소스별 대응, native 헤더 override와 응답 정책을 설명합니다.

SecurityGroups.Resources.List/All의 resource.WithFilter/WithFilters는 query17개·accepted 이름21개와 로컬 Body3개를 분류합니다. is_shared와 태그 query 별칭을 변환하며 revision_number·tenant_id·project_id·stateful·name·id는 서버 조건입니다. created_at·updated_at·security_group_rules는 원문 JSON으로 비교하며 rule의 unknown 필드·큰 숫자·null 요소를 보존합니다. native Group와 nested Rule의 알려진 필드·timestamp 디코드를 전체 페이지에 먼저 적용하고 기존 typed SecGroup을 반환합니다. concrete native ListOpts가 지원하지 않는 반복/nil/확장 query는 SDK 소유 raw pager가 보존합니다. 기존 WithName의 로컬 이름 비교와 typed native List·FindIdentity·Get/Delete·rule 변경 API는 유지하며 WithStatus는 native Status가 없어 미지원입니다. semantic status는 버리고 raw status는 query로 전달합니다. Network(ctx).API.SecurityGroups.Resources와 NetworkV2(ctx).SecurityGroups.Resources는 같은 캐시된 client를 사용합니다. Security Group Python/Go 사용법에 전체 이름과 원문 rule·native decoder·페이지 차이를 설명합니다.

Routers.Resources.List/All의 resource.WithFilter/WithFilters는 query18개·accepted 이름24개와 로컬 Body10개를 분류합니다. bool query 세 개와 태그 별칭을 변환하며 name·status·id는 서버 조건입니다. gateway·routes·availability zone·timestamp·tenant ID는 원문 JSON, enable_ndp_proxy는 null을 보존한 boolean truthiness, evpn_vni와 revision은 정확한 정수로 비교합니다. Python revision_number와 명시 Body 별칭은 raw revision을 선택하며 native 반환값의 RevisionNumber가 읽는 revision_number로 fallback하지 않습니다. native 전체 페이지의 nested 필드·revision·timestamp 디코드는 먼저 수행합니다. 기존 WithName·WithStatus와 최종 wire status·native typed List·FindIdentity·Get/Delete·interface 변경 API는 유지합니다. Network(ctx).API.Routers.Resources와 NetworkV2(ctx).Routers.Resources는 캐시된 같은 client를 사용합니다. Router Python/Go 사용법에 전체 이름과 null·변환·native decoder·페이지 차이를 설명합니다.

Trunks.Resources.List/All의 resource.WithFilter/WithFilters는 query14개·accepted 이름18개와 원문 JSON 로컬 Body2개를 분류합니다. admin state·태그 query 별칭을 변환하며 id·tenant_id는 원문 조건, project_id·sub_ports·name·status는 서버 조건입니다. project response alias는 tenant Body를 query로 바꾸지 않으며 native timestamp/revision은 semantic 이름으로 받지 않습니다. native Trunk/Subport 전체 페이지 디코드와 RFC3339 timestamp, inherited links.next 순회를 유지합니다. 기존 WithName의 정확한 이름 비교와 WithStatus의 최종 query 값에 대한 대소문자 무시 비교는 유지하고 raw status 단독은 로컬 조건을 추가하지 않습니다. typed native List·FindIdentity·Get/Delete·subport 변경 API는 유지하며 Network(ctx).API.Trunks.Resources와 NetworkV2(ctx).Trunks.Resources는 같은 캐시된 client를 사용합니다. Trunk Python/Go 사용법에 전체 이름과 raw/native·페이지 차이를 설명합니다.

Networks.Resources.List/All과 상위 Network(ctx).Networks의 resource.WithFilter/WithFilters는 query23개·accepted 이름35개와 로컬 Body14개를 분류합니다. provider·address scope·bool·태그 query 별칭을 변환하고 name·status·id는 서버 조건입니다. 원문 subnets·availability zone·segments·timestamp·확장 필드와 네 boolean 응답의 truthiness·두 정수의 정확한 변환을 SDK가 처리하며 native Network를 반환합니다. 기존 WithName의 정확한 이름 비교와 WithStatus의 대소문자 무시 상태 비교는 별도로 유지하며 두 목록 경로 모두 raw status query를 보존합니다. SDK-owned Networks.ResourceAdapter()의 독립 metadata를 공유 조립하고 상위 facade의 singular network 오류 이름·exact ERROR 대기는 유지합니다. native typed List·FindIdentity·Get/Delete는 이 semantic 옵션과 독립적입니다. Network Python/Go 사용법에 전체 이름과 null·변환·native decoder·페이지 차이를 설명합니다.

SubnetPools.Resources.List/All의 resource.WithFilter/WithFilters는 query16개·accepted 이름20개와 로컬 Body10개를 분류합니다. is_shared·태그 query 별칭을 변환하고 id·tenant ID·두 timestamp·prefix 배열·다섯 정수 속성은 원문에서 비교합니다. Python prefix length 이름을 wire 필드에 연결하며 정수에는 정확한 정수 정책을 적용합니다. native 전체 페이지의 필수 prefix length·quota/revision·timestamp 디코드는 먼저 수행하고 반환값은 기존 typed SubnetPool입니다. raw id/status query·기존 WithName·typed List·FindIdentity·prefix 변경 API는 각각 유지합니다. Subnet Pool Python/Go 사용법에 전체 이름과 Python 변환·응답·페이지 차이를 설명합니다.

QoSPolicies.Resources.List/All의 resource.WithFilter/WithFilters는 서버 query15개·accepted 이름19개와 로컬 Body2개를 분류합니다. is_shared와 태그 query 별칭을 변환하고 bulk canonical 값이 우선합니다. rules·deprecated tenant_id는 원문 행에서 비교하며 id·name·project_id·bool 속성·태그는 서버 query입니다. 큰 rule 숫자는 원문으로 비교하고 native float64 반환값은 유지합니다. 기존 WithName·raw status query·typed List·FindIdentity는 각각 유지합니다. QoS Policy Python/Go 사용법에 전체 필터·옵션·응답·페이지 차이를 설명합니다.

SecurityAddressGroups.Resources.List/All의 resource.WithFilter/WithFilters는 서버 query 8개와 로컬 Body 속성 3개를 분류합니다. name·project_id는 서버 query이고 id·tenant_id·addresses는 native 전체 페이지 디코드 뒤 원본 행에서 비교합니다. native 모델에 없는 tenant ID와 주소 배열의 null 요소를 보존해 비교하며 결과는 typed AddressGroup입니다. 기존 WithName의 hint와 로컬 이름 조건, raw status query, native typed List와 FindIdentity는 각각 유지합니다. AddressGroup Python/Go 사용법에 필터·원문 응답·plural-links 페이지 경계를 설명합니다.

QoSPolicies.Resources의 rules, SecurityAddressGroups.Resources의 addresses, SubnetPools.Resources의 prefixes, Networks.Resources의 subnets는 resource.WithBodyFilter/WithBodyFilters로 로컬에서 비교합니다. SDK가 필드 선택·JSON snapshot·배열 전체 equality를 처리하며 builder나 predicate를 구현하지 않습니다. Network의 Python 이름 subnet_ids도 subnets의 SDK 별칭으로 받으며 bulk에서 두 이름을 함께 지정하면 HTTP 전에 거부합니다. 상위 network.Service.Networks에도 같은 필터가 연결됩니다. nil/빈 배열과 raw cap 이후 비교를 구분하고 raw wire query는 자동 분류하지 않습니다. 이 옵션은 ordinary Resources.List/All만 받으며 native typed List·FindIdentity와 다른 리소스는 별도입니다. Python/Go Body 필터 비교를 참고합니다.

Subnets.Resources는 선언된 로컬 Body 필드 9개도 지원합니다. allocation pools·DNS nameservers·host routes·service types·timestamp·prefix length·tenant ID·revision number를 원본 페이지 행으로 비교하며 typed Subnet을 반환합니다. prefix_length는 prefixlen의 SDK 별칭이고 native 전체 페이지 디코드가 먼저 적용됩니다. Subnet Python/Go 사용법에 숫자 정밀도·누락/null·native decoder 경계를 설명합니다.

Subnets.Resources.List/All의 resource.WithFilter/WithFilters는 Python 속성 이름을 서버 query 24개 또는 로컬 Body 9개로 자동 분류합니다. query의 wire 별칭을 포함한 30개 이름, bulk canonical 우선·최종값 검증·semantic 전체 교체/clear·JSON snapshot을 SDK가 처리합니다. raw query·명시 Body·page/name hint와 같은 target을 지정하면 HTTP 전에 오류이며, 알 수 없는 semantic 이름은 버립니다. 현재 이 분류는 Subnet에 연결되어 있고 고정 Python AST manifest의 현재 소스 검증을 통과해야 생성됩니다. 전체 Resource/cache·상속 continuation/session·Proxy conflicting attrs·JMESPath 조건은 별도입니다. Subnet 사용법을 참고하세요.

conn.NetworkProjectQuotas(ctx, project)와 CurrentNetworkProjectQuotas(ctx)는 Neutron quota를 고정된 프로젝트 singleton으로 제공합니다. Get/Defaults/Detail/Update/Delete와 check_limit, 별도 ListProjects/AllProjects 목록·로컬 소비 옵션은 프로젝트 quota 사용법을 참고합니다.

Go 사용

// context.Context ctx, *openstack.Connection conn을 사용하는 함수 안에서
service, err := conn.NetworkV2(ctx)
if err != nil { return err }
for value, err := range service.Networks.Resources.List(ctx) {
    if err != nil { return err }
    fmt.Println(value)
}
value, err := service.Networks.Find(ctx, resource.Name("example"))
if err != nil { return err }
_ = value

예제의 fmt는 표준 라이브러리, resource는 github.com/JSYoo5B/go-openstacksdk/resource입니다. Find는 기본적으로 미존재를 오류로 처리합니다. resource.WithIgnoreMissing()을 추가하면 nil, nil을 반환합니다. Delete의 기본값은 미존재 무시입니다.

리소스와 공통 정책

공통 Collection은 정확한 이름 검색, 중복 이름 오류, 페이지 순회, context 취소와 HTTP 오류 보존을 적용합니다. 상태가 없는 리소스의 Wait는 ErrUnsupported를 반환합니다.

native pager에 연결된 Resources.List/All과 부모 scope의 List/All은 resource.WithMaxItems(n)과 resource.WithPaginated(false)로 raw 행 소비량과 첫 페이지를 제어합니다. cap은 로컬 name/status 및 Trove 사용자 host 필터 전에 적용합니다. 0은 무제한이며 음수는 lazy 순회 시 HTTP 전에 오류입니다. native 경로는 cap을 wire limit hint로 보내지 않고 명시 페이지 크기·query·header를 보존합니다. 페이지 전체 extraction 때문에 cap 뒤 malformed 행도 오류를 낼 수 있습니다. 기존 native typed List의 작업별 옵션은 유지하며, 공통 소비 옵션은 Collection/scope에 전달합니다. 서비스별 Python/Go 목록 비교에서 실제 binding과 continuation 정책을 확인합니다.

변경 요청

리소스 API의 Create/Update에 concrete options를 전달합니다. 기본 필드는 typed options로 지정하고 추가 필드는 With...Field로 지정합니다. query와 header도 해당 연산이 제공하는 With... 함수를 사용합니다. 기본 필드·헤더 덮어쓰기와 지원되지 않는 확장 방식은 요청 전에 거부합니다. 요청 builder interface는 SDK가 구현합니다.

부모가 필요한 연산은 범위 객체를 사용합니다. 범위 객체가 제공하는 Create/Update에도 같은 concrete options를 사용합니다. 응답 변경 추적이나 Python cloud의 모든 복합 작업은 이 API 참조 페이지의 지원 범위를 뜻하지 않습니다.

전체 비교 기준은 openstacksdk 목록, Go API 호출은 전체 API 설명, 실행·검증은 프로젝트 README를 참고합니다.