client.DNSConnections
इस नेमस्पेस का हर मेथड: उसका सिग्नेचर, उसके पैरामीटर, वह क्या लौटाता है और एक उदाहरण।
मेथड
The DNS provider accounts connected to the workspace, through which OpenEmail writes the records of a domain itself: list them, read what disconnecting one would leave behind, and disconnect it. Connecting one is done in the app, because the provider asks the person to sign in.
DNSConnections.List
List the DNS provider accounts connected to the workspace
List(ctx context.Context, opts ...openemail.RequestOption) (openemail.Object, error)Returns every DNS provider account connected to the workspace, through which OpenEmail writes the records of a domain itself, as the Providers tab of the domains page in the app shows them. Each one names the domains it serves, how many records OpenEmail wrote through it and still keeps, and whether it is active, needs connecting again (needs-reauth) or was disconnected (revoked).
configured is false when this server cannot connect a provider at all. A connection is made in the app, because the provider asks the person to sign in, so there is no method to create one.
पैरामीटर
openemail.WithAPIKeystringOverrides the client's API key for this call only.
लौटाता है
An openemail.Object, with every connection in data, disconnected ones included.
उदाहरण
connection, err := client.DNSConnections.List(ctx)if err != nil { return err} fmt.Println(connection.Bool("configured"))टिप्पणियाँ
A GET is retried automatically on network failure and on 408, 500, 502, 503 and 504 responses, up to the client's
openemail.WithMaxRetries, and on a 429 only when it carries aRetry-Afterof a minute or less.
इनमें भी उपलब्ध
DNSConnections.Get
Read a DNS connection and what disconnecting it would leave behind
Get(ctx context.Context, id string, opts ...openemail.RequestOption) (openemail.Object, error)Returns one connection with what disconnecting it would do: the domains it serves, the records OpenEmail wrote through it, busy for the domains a sync is running on right now, which hold a disconnect back until it ends, and keepsMail for the verified domains that stop receiving mail once their records come down.
पैरामीटर
idstringआवश्यकA connection id from
List.openemail.WithAPIKeystringOverrides the client's API key for this call only.
लौटाता है
An openemail.Object.
उदाहरण
connection, err := client.DNSConnections.Get(ctx, "dnsl_3f9a1c2e7b4d4e6f8a0b2c3d")if err != nil { return err} fmt.Println(connection.String("id"), connection.String("status"))टिप्पणियाँ
A connection id that is not in this workspace is a 404
resource_not_found.A GET is retried automatically on network failure and on 408, 500, 502, 503 and 504 responses, up to the client's
openemail.WithMaxRetries, and on a 429 only when it carries aRetry-Afterof a minute or less.
इनमें भी उपलब्ध
DNSConnections.Delete
Disconnect a DNS provider account
Delete(ctx context.Context, id string, opts ...openemail.RequestOption) (openemail.Object, error)Disconnects the account as Disconnect does in the app: the records OpenEmail wrote through it come down, every domain it serves is detached, and the connection is revoked at the provider. A verified domain whose records come down stops receiving mail, so read Get first. detached counts what came down and lists the records still published, to delete by hand.
A connection that is already disconnected is removed from the list instead, once no domain and no record is left on it, and removed says so.
पैरामीटर
idstringआवश्यकA connection id from
List.openemail.WithAPIKeystringOverrides the client's API key for this call only.
लौटाता है
An openemail.Object with removed, confirmed and detached.
उदाहरण
result, err := client.DNSConnections.Delete(ctx, "dnsl_3f9a1c2e7b4d4e6f8a0b2c3d")if err != nil { return err} fmt.Println(result.Bool("removed"), result.Object("detached").Int("detached"))टिप्पणियाँ
A sync running on one of its domains is refused with 409
dns_busy, and nothing is revoked. A disconnected connection that still has domains or records on it is refused with 409dns_connection_in_use.A key or an access token limited to particular addresses or domains is refused with 422
capability_unsupported. An access token acting for a member also needsworkspace:managein their role, or it is refused with 403insufficient_authority.An OAuth access token needs a verification code for this call, and is refused with 403
step_up_requireduntil the app has verified one in the last 60 minutes. The error matchesopenemail.ErrStepUpRequired. An API key is never asked for a code.Not retried by the SDK.