Skip to content
Start here

Retrieve managed label

client.APIGateway.Labels.Managed.Get(ctx, name, params) (*LabelManagedGetResponse, error)
GET/zones/{zone_id}/api_gateway/labels/managed/{name}

Retrieve managed label

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
Accepted Permissions (at least one required)
Account API GatewayAccount API Gateway ReadDomain API GatewayDomain API Gateway Read
ParametersExpand Collapse
name string

The name of the label

params LabelManagedGetParams
ZoneID param.Field[string]

Path param: Identifier.

maxLength32
WithMappedResourceCounts param.Field[bool]Optional

Query param: Include mapped_resources for each label

ReturnsExpand Collapse
type LabelManagedGetResponse struct{…}
CreatedAt Time
formatdate-time
Description string

The description of the label

LastUpdated Time
formatdate-time
Metadata unknown

Metadata for the label

Name string

The name of the label

Source LabelManagedGetResponseSource
  • user - label is owned by the user
  • managed - label is owned by cloudflare
One of the following:
const LabelManagedGetResponseSourceUser LabelManagedGetResponseSource = "user"
const LabelManagedGetResponseSourceManaged LabelManagedGetResponseSource = "managed"
MappedResources unknownOptional

Provides counts of what resources are linked to this label

Retrieve managed label

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/api_gateway"
  "github.com/stainless-sdks/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  managed, err := client.APIGateway.Labels.Managed.Get(
    context.TODO(),
    "login",
    api_gateway.LabelManagedGetParams{
      ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", managed.CreatedAt)
}
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "created_at": "2014-01-01T05:20:00.12345Z",
    "description": "All endpoints that deal with logins",
    "last_updated": "2014-01-01T05:20:00.12345Z",
    "metadata": {
      "foo": "bar"
    },
    "name": "login",
    "source": "managed",
    "mapped_resources": {
      "operations": 29
    }
  },
  "success": true
}
Returns Examples
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "created_at": "2014-01-01T05:20:00.12345Z",
    "description": "All endpoints that deal with logins",
    "last_updated": "2014-01-01T05:20:00.12345Z",
    "metadata": {
      "foo": "bar"
    },
    "name": "login",
    "source": "managed",
    "mapped_resources": {
      "operations": 29
    }
  },
  "success": true
}